API가 뭐죠?

IT부서와 협업을 하거나 뉴스를 보다 보면 심심찮게 나오는 단어가 "API"입니다.

 

비플라이소프트, ‘뉴스 데이터’ API 사업 본격적 시동…플로우와 전략적 사업 협력 MOU 체결

 

"아태지역 금융 서비스 API 공격 약 250% 증가"

 

IT 쪽 지식이 없는 분들에게는 API가 무엇인지 검색을 해봐도 잘 와닿지 않습니다. 데이터 분석가로서 직무 인터뷰를 했을 때, API가 무엇인지 설명해 달라는 질문을 받았었지만 제대로 이해시키지 못했던 경험이 있습니다. 비전공자와 IT분야와 친숙하지 않은 분들에게 이를 설명하기가 어려웠습니다. 그래서 이번 포스팅에서는 API가 무엇인지 쉽고 간단하게 설명해보려고 합니다.

 

API가 뭐예요?

 

API는 메뉴다

API는 Application Programming Interface의 약자입니다. 위키피디아는 이렇게 정의를 하고 있습니다:

컴퓨터나 컴퓨터 프로그램 사이의 연결이다. 일종의 소프트웨어 인터페이스이며 다른 종류의 소프트웨어에 서비스를 제공한다. 이러한 연결이나 인터페이스를 빌드하거나 사용하는 방법을 기술하는 문서나 표준은 API 규격(사양)으로 부른다. 이 표준을 충족하는 컴퓨터 시스템은 API가 구현(implement)되었다거나 노출(expose)되었다고 말한다. API라는 용어는 사양이나 구현체를 의미할 수 있다.   예 무슨 말인지 1도 모르겠습니다.

 

API를 한 단어로 비유해 보자면 "메뉴판"입니다.

 

음식을 제공하는 식당에 가면 메뉴판을 가장 먼저 줍니다. 그리고 사람들은 메뉴판에 있는 메뉴를 보고 주문을 합니다.

이 메뉴판을 보고 팬케이크 하우스에 가서 아래 메뉴에 없는 짜파구리를 시키거나, 소주를 한 병 시키는 사람은 없을 겁니다. 하지만 메뉴판에 적혀있는 대로 팬케이크에 바나나 토핑을 추가한다던지, 시럽을 빼달라는 등의 요구는 할 수 있을 겁니다. 식당은 메뉴판을 통해서 손님들에게 어떤 서비스가 제공가능하며, 해당 메뉴는 어떤 재료로 구성이 되어있는지 설명을 해줄 수 있습니다. 

제가 좋아하는 팬케이크 하우스 메뉴판입니다 ㅎㅎ

 

여기서 식당은 API를 제공하는 프로그램이며, 주문을 하는 손님들은 API를 사용하는 프로그램입니다. 즉, 프로그램들은 API를 통해서 어떻게 정보를 주고받을지 알 수 있습니다. 

 

ChatGPT API를 예시로 들어보겠습니다.

 

몇 달 전 토스에서 ChatGPT API를 사용해서 토스 앱에 "ChatGPT에게 물어보기" 기능을 도입한 적이 있습니다. 여기서 토스 앱 내 프로그램은 ChatGPT라는 메뉴를 API를 통해 주문한 손님이고, OpenAI사의 프로그램은 메뉴를 제공한 음식점이라고 보면 될 것 같습니다. 

 

OpenAI는 API라는 메뉴판에 대한 상세 설명을 다음과 같은 Documentation (설명서) 형태로 웹사이트에 제공을 하고 있습니다. 

 

https://platform.openai.com/docs/api-reference/completions/create

 

음식점을 이용하기 위해서는 API라는 메뉴판이 필요하고, 메뉴판을 이용하기 위해서는 일종의 입장권인 API Key의 발급이 필요할 수도 있습니다. API의 유료/무료 여부는 제공하는 회사의 운영 방침에 따라 달라질 수도 있습니다. 일부 메뉴는 무료이거나, 일정량(API rate limit)만 무료로 주문을 할 수 있고, 어떤 메뉴는 특별하기 때문에 추가요금을 지불하거나 특수한 자격을 갖춘 사람들만 주문할 수 있는 경우도 존재합니다.

 

 

 

1줄 요약:

API는 프로그램이 프로그램에게 제공하는 메뉴판입니다.