용어집

애플리케이션 프로그래밍 인터페이스(API)란?

애플리케이션 프로그래밍 인터페이스 또는 API는 사용자(사람 또는 소프트웨어)와 정보(온라인 및 웹 애플리케이션에서 제공하는 데이터 리소스)라는 두 엔터티 간의 통신을 가능하게 하는 일련의 정의, 규칙 및 프로토콜입니다.

오늘날 API는 최신 애플리케이션의 기본 프레임워크를 형성하고 사용자 경험을 개선하며 비즈니스 모델을 향상시킵니다. 때로는 API가 비즈니스 모델 그 자체가 되기도 합니다.

API의 작동 방식

API는 애플리케이션의 “공개적인 얼굴”로, 애플리케이션이 수행하는 기능과 제공할 수 있는 정보를 나타내며 적절한 요청 형식을 정의합니다. 개발자가 애플리케이션의 API를 생성하여 노출하면 다른 애플리케이션이 애플리케이션과 통신할 수 있게 됩니다.

많은 경우 API는 일반적으로 사용되는 기능을 쉽게 사용할 수 있도록 하기 때문에 개발자의 소중한 시간을 절약해 줍니다. 개발자는 기존 애플리케이션의 기능을 복제하기 보다는 기존 애플리케이션의 API를 호출하여 해당 기능을 애플리케이션에 통합할 수 있습니다.

WhatIsAnAPI-Glossary

각 API의 설계, 배포 및 작동 방식은 아키텍처 스타일이나 프로토콜에 따라 다릅니다.

API 아키텍처 및 프로토콜의 유형

API 아키텍처 또는 아키텍처 스타일은 API의 고수준 설계를 나타냅니다. 여기에는 API의 구조화 및 구성 방법과 요청/응답 형식이 포함됩니다. 또한 API 프로토콜은 형식을 지정하는 동시에 정확한 메시지를 추가로 설명합니다.

일반적인 API 아키텍처 및 프로토콜은 다음과 같습니다.

  • REST - RESTful이라고도 하는 이 아키텍처 스타일은 Representational State Transfer(REST) 원칙을 기반으로 합니다. HTTP 메서드(예: GET, POST, PUT, DELETE)와 추상화된 정보(리소스 및 리소스 모델 형태)를 사용하여 확장 가능하고 유연하며 기술적으로 독립적인 구조를 만듭니다. 오늘날 REST는 가장 일반적인 API 아키텍처입니다.
  • GraphQL - Meta(구 Facebook)에서 개발한 오픈 소스 쿼리 언어인 GraphQL 아키텍처는 한 번의 API 호출로 여러 소스에서 데이터를 가져올 수 있습니다. 클라이언트는 필요한 데이터만 요청하기 때문에 캐시 가능성은 떨어지지만 GraphQL API가 REST API보다 효율적인 경향이 있습니다.
  • SOAP - 이 아키텍처 접근 방식은 Simple Object Access Protocol(SOAP)을 사용합니다. SOAP 메시지는 일반적으로 XML로 형식이 지정되므로 REST 또는 GraphQL보다 부피가 큽니다. REST API와 달리 SOAP API에는 API 프로토콜의 구조를 정의하는 엄격한 구현 지침이 있습니다.
  • WebSocket - 이 API 프로토콜은 전이중 방식이므로 클라이언트와 서버가 동시에 메시지를 보내고 받을 수 있습니다. 또한 서버는 클라이언트 요청에 대한 응답이 아닌, 예를 들어 서버 측 이벤트에 의해 트리거되는 메시지 등도 보낼 수 있습니다. 이와 대조적으로 REST API는 엄격한 요청-응답 패턴을 따릅니다.
  • RPC - 원격 프로시저 호출을 사용하여 개발자는 원격 상호 작용의 세부 사항을 지정할 필요 없이 동일한 코드를 사용하여 로컬 함수와 다른 주소 공간(일반적으로 원격 서버)에서 실행되는 함수를 호출할 수 있습니다. 이 프로토콜은 여러 언어를 사용할 수 있으므로 유연하며 일반적으로 클라이언트-서버 통신에 사용됩니다. RPC의 한 예로 gRPC(Google Remote Procedure Call)가 있습니다.
오늘날 API가 사용되는 방식

API는 최신 소프트웨어의 중요한 부분입니다. 오늘날의 조직과 비즈니스는 필요에 따라 다양한 유형의 API를 구축하거나 사용합니다.

오늘날 조직에서 가장 흔히 볼 수 있는 네 가지 유형의 API는 공개 API, 비공개 API, 파트너 API, 타사 API입니다.

공개 API

공개 API는 기업 외부의 사용자가 유료 또는 무료로 액세스할 수 있으며 타사 개발자와 파트너십을 구축하고 전체 비즈니스 생태계를 확장할 수 있게 해줍니다.

공개 API는 타사 개발자가 새로운 제품을 만드는 데 사용할 수 있으므로 혁신을 촉진하고 새로운 파트너십을 구축하는 데 도움을 주는 중요한 도구입니다.

비공개 API

비공개 API는 기업 내부 팀만 액세스할 수 있습니다. 데이터를 활용하고 내부 협업을 촉진하는 데 도움이 되거나, 조직의 공개 애플리케이션(예: 웹사이트)을 보이지 않게 지원할 수도 있습니다.

비공개 API는 내부 사용자만 사용할 수 있으므로 조직은 최적화를 염두에 두고 구축할 수 있습니다. 또한 비공개 API를 사용하면 최신 애플리케이션의 결합성이 개선되어 비즈니스를 현재의 요구 사항에 맞게 조정할 수 있습니다. 개발자는 마이크로서비스를 구축하면서 비공개 API를 쉽게 통합할 수 있으므로 팀 간에 중복되는 작업을 줄일 수 있습니다.

파트너 API

파트너 API는 비즈니스 파트너와 직접 통합하는 데 사용됩니다(예: 항공사가 호텔 체인과 제휴하여 항공편과 숙박을 동시에 예약할 수 있는 경우). 파트너 API는 공개적으로 사용할 수 없으며 양사의 인증(AuthN) 및 권한 부여(AuthZ) 요구 사항을 충족하는 일부 개발자만 액세스할 수 있습니다.

상호 운용성은 사일로를 허물고 서로 다른 조직이 서로 소통할 수 있도록 지원하므로 파트너 API와의 관계를 강화합니다.

타사 API

타사 API는 조직에서 애플리케이션 및 서비스에서 누락된 데이터 또는 기능에 액세스하는 데 사용됩니다. 이러한 API는 타사의 서버에서 실행되며 일반적으로 폭넓게 필요한 서비스를 제공합니다(예: 많은 전자 상거래 웹사이트에서 사용하는 Stripe 결제 처리 API). API에 따라 조직에서 유료 또는 무료로 사용할 수 있습니다.

타사 API는 이미 다른 개발자나 조직에서 구축한 것이므로 비용 절감이라는 확실한 이점이 있습니다. 또한 타사 API는 개발자가 직접 코딩하지 않고도 기능을 즉시 사용할 수 있으므로 조직이 앱을 더 빠르게 개발할 수 있는 핵심적인 방법이기도 합니다.

API를 만드는 데 사용되는 애플리케이션 언어

거의 모든 최신 프로그래밍 언어를 사용하여 API를 코딩할 수 있습니다. API를 코딩할 때 많은 개발자가 프레임워크를 사용할 수 있습니다. 프레임워크는 코드 라이브러리 및 기타 필요한 유틸리티와 같은 빌딩 블록을 제공하여 해당 언어를 사용하여 애플리케이션을 더 빠르고 쉽게 구축할 수 있도록 해줍니다.

각 프로그래밍 언어에는 일반적으로 개발자 사이에서 인기 있는 프레임워크가 하나 이상 있습니다. 다음 표에는 여러 가지 프레임워크 옵션이 나와 있습니다(대부분은 오픈 소스임).

 

언어

프레임워크

Java

Spring

JavaScript, Node.js

Angular, Express.js, React, Vue

PHP

Laravel, Slim, Symfony

Python

Django, Flask

Rust

Rocket, Yew, Actix-Web

Ruby

Rails

어떤 언어와 프레임워크를 선택할지는 일반적으로 프로젝트의 요구 사항이나 개발자의 개인적 선호도에 따라 달라집니다.

API의 예

오늘날 조직은 목표에 부합하는 최신 API 전략이 필요합니다. API 전략은 조직이 API를 설계, 개발, 관리, 통제 및 보호하는 방법에 대한 계획을 수립하는 것입니다.

Gartner의 소프트웨어 엔지니어링 리더를 위한 상위 5가지 API 교훈에 따르면, 다음과 같이 강력한 API 전략을 위한 5가지 모범 사례가 있습니다.

  • API 거버넌스로 인해 병목 지점이 발생하지 않도록 합니다. 혁신을 지속적으로 추진하려면 API 거버넌스와 개발자 민첩성이 균형을 이루어야 합니다.
  • 유료화할 계획이 없더라도 API를 제품으로 취급합니다. 각 API에는 비즈니스 목표에 부합하는 명확한 목표와 대상이 있어야 합니다.
  • 해커보다 먼저 API를 찾아냅니다. 검색 능력을 우선시하고 정기적으로 모니터링하면 보안 침해를 방지하는 데 도움이 됩니다.
  • API의 수명 주기를 관리합니다. 포괄적인 API 수명 주기 관리를 통해 API가 적절한 보안을 유지하며 계속 작동할 수 있도록 보장합니다.
  • 가장 적합한 API 기술을 선택합니다. 한 조직에 적합한 기술이 다른 조직에는 적합하지 않을 수 있으므로 현재와 미래의 특정 API 요구 사항을 자세히 고려하는 것이 중요합니다.
API 연결이란?

API는 개발자를 위한 도구로 시작했지만, 이제는 수익을 증대하고 기업 민첩성을 지원하는 전략적 비즈니스 자산으로 성장했습니다. API 연결은 가시성, 보안 및 거버넌스 문제를 해결하기 위해 모듈식 재사용 가능한 API를 사용하여 클라우드 네이티브 환경에서 데이터와 애플리케이션을 연결하는 것을 말합니다.