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

API 아키텍처는 일반적으로 클라이언트와 서버 측면에서 설명됩니다. 요청을 보내는 애플리케이션을 클라이언트라고 하고 응답을 보내는 애플리케이션을 서버라고 합니다. 따라서 날씨 예에서 기상청의 날씨 데이터베이스는 서버이고 모바일 앱은 클라이언트입니다. 

API가 생성된 시기와 이유에 따라 API는 네 가지 방식으로 작동할 수 있습니다.

SOAP API 

이 API는 단순 객체 접근 프로토콜을 사용합니다. 클라이언트와 서버는 XML을 사용하여 메시지를 교환합니다. 과거에 더 많이 사용되었으며 유연성이 떨어지는 API입니다.

RPC API

이 API를 원격 프로시저 호출이라고 합니다. 클라이언트가 서버에서 함수나 프로시저를 완료하면 서버가 출력을 클라이언트로 다시 전송합니다.

Websocket API

Websocket API는 JSON 객체를 사용하여 데이터를 전달하는 또 다른 최신 웹 API 개발입니다. WebSocket API는 클라이언트 앱과 서버 간의 양방향 통신을 지원합니다. 서버가 연결된 클라이언트에 콜백 메시지를 전송할 수 있어 REST API보다 효율적입니다.

REST API

오늘날 웹에서 볼 수 있는 가장 많이 사용되고 유연한 API입니다. 클라이언트가 서버에 요청을 데이터로 전송합니다. 서버가 이 클라이언트 입력을 사용하여 내부 함수를 시작하고 출력 데이터를 다시 클라이언트에 반환합니다. 아래에서 REST API에 대해 더 자세히 살펴보겠습니다.

웹 API 또는 웹 서비스 API는 웹 서버와 웹 브라우저 간의 애플리케이션 처리 인터페이스입니다. 모든 웹 서비스는 API이지만 모든 API가 웹 서비스는 아닙니다. REST API는 위에서 설명한 표준 아키텍처 스타일을 사용하는 특수한 유형의 웹 API입니다.

역사적으로 API가 월드 와이드 웹 전에 만들어졌기 때문에 Java API, 서비스 API 등 API에 대한 다양한 용어가 존재합니다. 최신 웹 API는 REST API이며 용어는 서로 바꿔 사용할 수 있습니다.

REST API는 다음과 같은 네 가지 주요 이점을 제공합니다.

1. 통합 

API는 새로운 애플리케이션을 기존 소프트웨어 시스템과 통합하는 데 사용됩니다. 그러면 각 기능을 처음부터 작성할 필요가 없기 때문에 개발 속도가 빨라집니다. API를 사용하여 기존 코드를 활용할 수 있습니다.

2. 혁신 

새로운 앱의 등장으로 전체 산업이 바뀔 수 있습니다. 기업은 신속하게 대응하고 혁신적인 서비스의 신속한 배포를 지원해야 합니다. 전체 코드를 다시 작성할 필요 없이 API 수준에서 변경하여 이를 수행할 수 있습니다.

3. 확장

API는 기업이 다양한 플랫폼에서 고객의 요구 사항을 충족할 수 있는 고유한 기회를 제공합니다. 예를 들어 지도 API를 사용하면 웹 사이트, Android, iOS 등을 통해 지도 정보를 통합할 수 있습니다. 어느 기업이나 무료 또는 유료 API를 사용하여 내부 데이터베이스에 유사한 액세스 권한을 부여할 수 있습니다.

4. 유지 관리의 용이성

API는 두 시스템 간의 게이트웨이 역할을 합니다. API가 영향을 받지 않도록 각 시스템은 내부적으로 변경해야 합니다. 이렇게 하면 한 시스템의 향후 코드 변경이 다른 시스템에 영향을 미치지 않습니다.

API 엔드포인트는 API 통신 시스템의 최종 접점입니다. 여기에는 서버 URL, 서비스 및 시스템 간에 정보가 송수신되는 기타 특정 디지털 위치가 포함됩니다. API 엔드포인트는 두 가지 주요 이유로 기업에 중요합니다. 

1. 보안

API 엔드포인트는 시스템을 공격에 취약하게 만듭니다. API 모니터링은 오용을 방지하는 데 중요합니다.

2. 성능

API 엔드포인트, 특히 트래픽이 많은 엔드포인트는 병목 현상을 일으키고 시스템 성능에 영향을 줄 수 있습니다.

다른 개발자가 사용하고 싶어하고 신뢰하는 API를 구축하려면 실사와 노력이 필요합니다. 고품질 API 설계에 필요한 5단계는 다음과 같습니다.

1. API 계획 

OpenAPI와 같은 API 사양은 API 설계를 위한 블루프린트를 제공합니다. 다양한 사용 사례를 미리 생각하고 API가 현재 API 개발 표준을 준수하는지 확인하는 것이 좋습니다.

2. API 빌드

 API 디자이너는 상용 코드를 사용하여 API 프로토타입을 생성합니다. 프로토타입이 테스트되면 개발자는 내부 사양에 맞게 이를 사용자 지정할 수 있습니다.

3. API 테스트  

API 테스트는 소프트웨어 테스트와 동일하며 버그 및 결함을 방지하기 위해 수행되어야 합니다. API 테스트 도구로 사이버 공격에 대비하여 API를 강화할 수 있습니다.

4. API 문서화  

API는 그 자체로 설명이 필요 없지만 API 문서는 사용 편의성은 높이는 가이드 역할을 합니다. 다양한 기능과 사용 사례를 제공하는 잘 문서화된 API는 서비스 지향 아키텍처에서 더 많이 사용되는 경향이 있습니다.

5. API 마케팅 

Amazon이 소매용 온라인 마켓플레이스인 것처럼 API 마켓플레이스는 개발자가 다른 API를 사고 팔기 위해 존재합니다. API를 나열하여 수익을 창출할 수 있습니다.

포괄적인 API 문서 작성은 API 관리 프로세스의 일부입니다. API 문서는 도구를 사용하여 자동 생성하거나 수동으로 작성할 수 있습니다. 몇 가지 모범 사례는 다음과 같습니다.

• 간단하고 읽기 쉬운 영어로 설명을 작성합니다. 도구로 생성된 문서는 장황하며 편집이 필요할 수 있습니다.
• 코드 샘플을 사용하여 기능을 설명합니다.
• 문서를 정확하고 최신 상태로 유지합니다.
• 초심자를 위한 작문 스타일을 목표로 합니다.
• API가 사용자를 위해 해결할 수 있는 모든 문제를 다룹니다.

새로운 웹 API는 API 마켓플레이스 및 API 디렉터리에서 찾을 수 있습니다. API 마켓플레이스는 누구나 판매용 API를 나열할 수 있는 개방형 플랫폼입니다. API 디렉터리는 디렉터리 소유자가 규제하는 제어된 리포지토리입니다. 전문 API 디자이너는 새 API를 디렉터리에 추가하기 전에 평가하고 테스트할 수 있습니다.  

인기 있는 몇몇 API 웹 사이트는 다음과 같습니다.

• RapidAPI – 10,000여 개의 퍼블릭 API와 현장에서 활동 중인 1백만 명의 개발자를 만날 수 있는 최대 규모의 글로벌 API 시장입니다. RapidAPI를 통해 사용자는 구매를 결정하기 전에 플랫폼에서 직접 API를 테스트할 수 있습니다.
• Public APIs – 이 플랫폼은 요구 사항에 맞는 API를 쉽게 탐색하고 찾을 수 있도록 원격 API를 40개의 틈새 범주로 그룹화합니다.
• APIForThat 및 APIList – 이 두 웹 사이트에는 사용 방법에 대한 심층 정보와 함께 500여 개의 웹 API 목록이 있습니다.    

GraphQL은 API용으로 특별히 개발된 쿼리 언어로서, 클라이언트에게 요청한 데이터만 제공하는 것을 우선으로 합니다. 또한 API를 빠르고 유연하며 개발자 친화적으로 만들도록 설계되었습니다. REST의 대안으로서 GraphQL은 프런트엔드 개발자에게 단일 GraphQL 엔드포인트로 여러 데이터베이스, 마이크로서비스 및, API를 쿼리할 수 있는 기능을 제공합니다. 조직은 애플리케이션을 더 빠르게 개발하는 데 도움이 되기 때문에 GraphQL을 사용하여 API를 빌드하기로 선택합니다. 여기에서 GraphQL에 대해 자세히 알아보세요.

AWS AppSync는 AWS DynamoDB, AWS Lambda 등의 데이터 소스에 안전하게 연결하는 힘든 작업을 처리하여 GraphQL API 개발을 용이하게 하는 완전관리형 서비스이며, Websocket을 통해 수백만 명의 클라이언트에 실시간 데이터 업데이트를 푸시할 수 있습니다. 모바일 및 웹 애플리케이션의 경우 AppSync는 디바이스가 오프라인 상태일 때 로컬 데이터 액세스 기능도 제공합니다. 배포된 후에는 AWS AppSync가 API 요청 볼륨에 따라 GraphQL API 실행 엔진을 자동으로 확장하고 축소합니다.