API가 뭐야?: 프로그램끼리 대화하는 규칙 5분 정리
날씨 앱이 어떻게 매번 최신 날씨를 보여주는지 궁금했던 적이 있다. 그 뒤에 있는 통로가 바로 API다.
API 한 줄 정의
**API(Application Programming Interface)**는 프로그램끼리 정보를 주고받는 약속·규칙의 모음이다.
풀어 말하면 이렇다. 한 서비스가 다른 서비스의 기능이나 데이터를 빌려 쓰고 싶을 때, 그 빌려 쓰는 방식을 미리 정해둔 약속이다. 이 약속을 따르면 두 프로그램이 직접 만나지 않아도 데이터를 주고받을 수 있다.
요즘 우리가 쓰는 거의 모든 디지털 서비스가 API 위에서 돌아간다. 카카오톡 로그인, 지도 앱의 위치 정보, 결제 시스템, ChatGPT 기능 연동까지 전부 API다.
중학생도 이해하는 비유
API를 이해하는 가장 쉬운 비유는 식당 메뉴판이다.
손님은 주방에 직접 들어가서 음식을 만들지 않는다. 메뉴판을 보고 “1번 메뉴 주세요”라고 점원에게 주문하면, 주방이 그 주문을 받아 요리해서 내준다. 손님은 주방 내부 사정을 몰라도 되고, 주방도 손님이 누군지 신경 쓰지 않는다.
API가 정확히 이 메뉴판 역할이다. 메뉴판에는 “이런 요청을 보내면 이런 결과가 돌아온다”가 적혀 있다. 프로그램은 그 메뉴판대로 요청만 보내면 원하는 데이터를 받을 수 있다. 상대 시스템이 어떻게 만들어졌는지 알 필요가 없다.
이 방식이 좋은 이유는 단순하다. 메뉴판만 안 바뀌면, 주방이 바뀌어도 손님은 같은 방식으로 주문할 수 있다. 서비스 내부 구조를 바꿔도 외부에 영향이 없다는 뜻이다.
실제 사용 예시
API는 보통 이런 형태로 쓰인다.
예시 1: 챗봇·AI 자동화 ChatGPT를 자기 서비스에 붙이고 싶을 때 OpenAI API를 호출한다. 사용자가 입력한 질문을 API로 보내면, 답변이 돌아온다. Claude Code, Cursor 같은 AI 코딩 도구도 내부에서 같은 방식으로 LLM API를 부른다.
예시 2: 외부 데이터 연결 날씨 앱은 기상청이나 외부 날씨 API를 호출해 최신 정보를 가져온다. 환율 앱, 주가 앱, 항공권 앱도 모두 외부 API를 통해 실시간 데이터를 받아 화면에 보여주는 구조다.
예시 3: 자동화 워크플로 Zapier, Make 같은 도구는 여러 서비스의 API를 연결해 자동 워크플로를 만든다. “Gmail에 새 메일이 오면 Slack에 알림 보내기”처럼, 두 서비스를 API로 연결해서 사람이 매번 손으로 옮길 필요가 없게 만든다.
비슷한 용어와 차이
헷갈리기 쉬운 개념을 정리했다.
| 용어 | 뜻 | API와의 관계 |
|---|---|---|
| SDK | API를 쉽게 부르도록 만든 코드 묶음 | API 위에 얹은 도구 |
| 라이브러리 | 자주 쓰는 기능을 모아놓은 코드 모음 | 보통 API 호출 코드를 안에 포함 |
| 프레임워크 | 앱 전체 뼈대 | 안에 여러 API 호출 패턴이 들어있다 |
| 엔드포인트 | API 안의 특정 주소(URL) | API의 한 메뉴판 항목 |
| API 키 | 사용자 인증용 비밀 문자열 | API 사용 권한 증명 |
따라서 “API = SDK”가 아니다. API는 약속이고, SDK는 그 약속을 따라 호출하기 편하게 미리 만들어 둔 코드라고 보면 된다.
언제 API를 마주치나
API라는 단어는 보통 이런 상황에서 나온다.
- AI 서비스 가격표: “API 호출당 0.01원”, “월 100만 토큰 API 사용 가능” 같은 안내
- 개발자 문서: 새 서비스를 연결할 때 가장 먼저 보게 되는 문서가 API 레퍼런스다
- 자동화 도구 설정: Zapier·Make에서 새 앱을 연결하려면 보통 API 키를 입력한다
- AI 코딩 도구 설명: “Claude API 기반”, “OpenAI API 호환” 같은 표현이 자주 등장한다
평소에는 API가 안 보인다. 자동화·연동·개발 단계로 들어가는 순간 거의 매일 마주치게 된다.
관련 용어
API를 이해했다면 함께 알아두면 흐름이 연결되는 용어들이다.
- CLI(Command Line Interface): 명령어로 프로그램을 다루는 인터페이스. API와 비슷하게 “프로그램과 대화하는 방식”이다.
- JSON: API 응답에 가장 많이 쓰이는 데이터 형식. 사람도 어느 정도 읽을 수 있는 구조다.
- HTTP: 웹 API가 동작하는 기본 통신 약속. GET, POST 같은 동작이 여기서 나온다.
- 토큰(Token): AI API 사용량을 측정하는 단위. 토큰(Token) 뜻 정리에서 자세히 다룬다.
API는 “프로그램끼리 정보를 주고받는 약속”이다. 식당 메뉴판처럼, 한쪽이 정해진 형식으로 요청하면 다른 쪽이 정해진 형식으로 응답한다. AI 서비스 연동, 자동화 워크플로, 외부 데이터 활용까지 거의 모든 디지털 작업의 뒤에 API가 있다는 점을 기억하면, 기술 문서가 한층 빨리 읽힌다.
출처
- MDN Web Docs, API 개요, https://developer.mozilla.org/
- OpenAI, API 레퍼런스, https://platform.openai.com/docs/
- Anthropic, API 레퍼런스, https://docs.anthropic.com/
