API란 무엇인가 - 식당 주문에 비유해서 이해하는 API 개념과 실생활 활용 사례 총정리
API가 뭔지 아는 척만 하고 계셨나요? 식당 주문 비유 하나로 API 개념을 완벽하게 잡고, 소셜 로그인부터 날씨 앱, 결제까지 매일 쓰는 API 사례와 직접 체험하는 방법까지 한 번에 정리했습니다.
개발자와 회의를 하다 보면 API라는 단어가 한 시간에 열 번도 넘게 나옵니다. 그때마다 아는 척 고개를 끄덕였지만 막상 설명해 보라면 말문이 막히는 분이 많습니다. 검색해 봐도 인터페이스가 어쩌고 하는 딱딱한 정의만 가득해서 오히려 더 헷갈리죠. API란 무엇인가라는 질문은 사실 식당 주문 장면 하나면 끝나는 이야기입니다. 이 비유 하나만 기억하면 소셜 로그인부터 날씨 앱, 온라인 결제까지 IT 서비스가 서로 연결되는 원리가 한눈에 들어옵니다.
API란 무엇인가 - 식당 점원 한 명이면 설명이 끝납니다
API는 Application Programming Interface의 약자로, 프로그램과 프로그램이 데이터를 주고받기 위해 미리 정해 둔 약속된 창구를 말합니다. 정의만 보면 어려우니 식당으로 옮겨 보겠습니다.
손님이 주방에 직접 들어가서 요리를 가져오는 식당은 없습니다. 손님은 점원에게 메뉴판에 있는 음식을 주문하고, 점원이 주문을 주방에 전달한 뒤 완성된 요리를 받아다 줍니다. 여기서 손님이 여러분이 쓰는 앱이고, 주방이 데이터를 가진 서버이며, 중간에서 주문을 전달하는 점원이 바로 API입니다.
API의 핵심 가치는 내부를 몰라도 쓸 수 있다는 점입니다. 손님이 주방 레시피를 몰라도 메뉴판만 보고 주문하듯, 개발자는 상대 서버의 내부 구조를 전혀 몰라도 API 문서만 보고 필요한 데이터를 받아올 수 있습니다.
메뉴판에 없는 음식을 주문하면 점원이 거절하듯, API도 정해진 형식에 맞지 않는 요청은 받아 주지 않습니다. 이 엄격한 규칙 덕분에 서로 다른 회사가 만든 수많은 서비스가 오류 없이 맞물려 돌아갈 수 있습니다.
우리가 매일 쓰는 API, 이미 하루에 수십 번 호출하고 있습니다
API는 개발자만의 도구가 아닙니다. 스마트폰을 켜는 순간부터 우리는 자신도 모르게 API를 계속 사용하고 있습니다.
- 소셜 로그인: 카카오나 구글 계정으로 몇 초 만에 가입하는 기능은 카카오와 구글이 제공하는 로그인 API를 각 서비스가 연동한 결과입니다.
- 날씨 앱: 날씨 앱 제작사는 직접 기상 관측을 하지 않습니다. 기상청이 제공하는 API에서 데이터를 받아와 보기 좋게 화면에 얹을 뿐입니다.
- 지도와 배달 앱: 배달 앱 안에서 라이더 위치가 표시되는 지도는 카카오맵이나 네이버 지도 API를 빌려 쓰는 것입니다.
- 온라인 결제: 쇼핑몰에서 카드 결제가 되는 것도 결제대행사의 결제 API를 연동했기 때문입니다.
이렇게 보면 하나의 앱은 사실 여러 회사의 API를 레고 블록처럼 조립한 결과물에 가깝습니다. 모든 기능을 직접 만들지 않고 잘 만들어진 API를 가져다 쓰기 때문에 개발 기간과 비용이 크게 줄어듭니다.
요청과 응답 - API가 실제로 일하는 방식
API 통신은 요청(Request)과 응답(Response) 두 단계로 이루어집니다. 앱이 서버에 "서울 날씨 알려줘"라고 요청하면 서버가 "맑음, 27도"라고 응답하는 구조입니다. 이때 요청의 목적을 구분하기 위해 HTTP 메서드라는 동사를 사용하는데, 웹에서 가장 널리 쓰이는 REST API의 기본 문법입니다.
| HTTP 메서드 | 역할 | 식당 비유 |
|---|---|---|
| GET | 데이터 조회 | 메뉴판 보여 주세요 |
| POST | 새 데이터 생성 | 주문 하나 넣어 주세요 |
| PUT | 기존 데이터 수정 | 주문한 메뉴를 바꿔 주세요 |
| DELETE | 데이터 삭제 | 주문 취소해 주세요 |
응답은 대부분 JSON이라는 텍스트 형식으로 돌아옵니다. 중괄호 안에 이름과 값이 짝을 이루는 단순한 구조라서 사람이 읽어도 대략 뜻을 알 수 있습니다. 응답에는 상태 코드도 함께 붙습니다. 200은 성공, 404는 요청한 데이터가 없다는 뜻, 401은 인증이 필요하다는 뜻입니다. 웹서핑 중 만나는 404 페이지가 바로 이 코드입니다.
오픈 API부터 유료 API까지 - 종류를 한눈에 정리
API는 누구에게, 어떤 조건으로 열려 있느냐에 따라 크게 세 가지로 나뉩니다.
- 오픈 API(공개 API): 누구나 신청해서 쓸 수 있는 API입니다. 기상청 날씨, 버스 도착 정보 같은 공공데이터가 대표적입니다.
- 파트너 API: 계약을 맺은 회사끼리만 쓰는 API입니다. 결제대행사와 쇼핑몰의 관계가 여기에 해당합니다.
- 내부 API: 한 회사 안에서 서비스끼리 데이터를 주고받을 때 쓰는 비공개 API입니다.
무료로 시작하더라도 호출량이 많아지면 과금되는 경우가 많습니다. 지도 API나 번역 API는 월 무료 한도를 넘기면 호출 건수에 따라 비용이 발생하므로, 서비스를 기획할 때 API 요금 정책부터 확인하는 것이 안전합니다.
비개발자가 API 감각을 키우는 현실적인 방법
코드를 짜지 않아도 API 감각은 충분히 키울 수 있습니다. 가장 쉬운 방법은 브라우저에서 F12를 눌러 개발자 도구의 네트워크 탭을 열어 보는 것입니다. 웹페이지를 새로고침하면 지금 이 순간 오가는 API 요청과 JSON 응답이 실시간으로 보입니다.
기획자나 디자이너라면 API가 실제 데이터를 내려 주기 전에 화면 시안부터 만들어야 하는 경우가 많습니다. 이때 데이터가 들어갈 자리를 비워 두면 완성도를 가늠하기 어려운데, Lorem Ipsum 생성기로 원하는 길이의 더미 텍스트를 만들어 채워 두면 실제 API 응답이 연결됐을 때의 화면을 미리 검증할 수 있습니다. 또 API 문서를 읽다 보면 색상 코드나 권한 플래그처럼 16진수로 표기된 값이 자주 등장하는데, 이런 값이 10진수로 얼마인지 궁금할 때는 진법 변환기를 쓰면 계산 없이 바로 확인됩니다.
오늘 해볼 액션은 두 가지입니다. 첫째, 지금 쓰는 브라우저에서 F12를 눌러 네트워크 탭으로 실제 API 응답을 한 번 구경해 보세요. 둘째, 공공데이터포털에서 관심 있는 오픈 API 하나를 무료로 신청해 보세요. 직접 인증키를 받아 보는 순간 API란 무엇인가라는 질문이 더 이상 남의 이야기가 아니게 됩니다.
