프로그램끼리
말 거는 법

API = 약속된 창구

은행 창구와 같다. 금고 안엔 못 들어가고, 대신 창구 직원한테 부탁한다.

"10만 원 출금이요"라고 말하면 직원이 알아서 해 준다. 금고가 어떻게 생겼는지는 몰라도 되고, 정해진 양식으로 부탁만 하면 된다.

프로그램끼리도 똑같다. 남의 프로그램 속은 직접 못 만지고, 그쪽이 열어둔 창구에 정해진 양식으로 요청한다. 그게 API, Application Programming Interface다.

날씨, 지도, 결제, 로그인을 전부 남의 창구에 부탁해서 가져온다. 바퀴를 다시 안 만들어도 된다.

REST, 주소와 동작으로 다룬다

창구가 수백 개면 외우기 힘들어서 규칙을 정한다. 그중 제일 흔한 게 REST다.

핵심은 둘이다. 다룰 대상은 URL 주소로 가리킨다(글 하나는 /posts/42). 무얼 할지는 메서드로 정한다.

메서드는 네 개가 기본이다. GET은 읽기, POST는 만들기, PUT은 고치기, DELETE는 지우기다.

그래서 한 줄로 뜻이 통한다. GET /posts/42는 "42번 글 보여줘"다. 동사 하나에 주소 하나면 끝난다.

데이터는 JSON으로 오감

요청을 보내면 답이 온다. 그 답을 담는 공용 포장지가 거의 다 JSON이다.

JSON은 키 : 값을 묶은 글자 덩어리다. 사람도 읽을 수 있고 컴퓨터도 바로 알아먹는다. "temp": 19처럼 이름표를 붙여 적는다.

글자로 주고받는 건 언어가 달라도 통하기 때문이다. 파이썬이 보낸 걸 자바스크립트가 읽고, 자바가 만든 걸 스위프트가 읽는다. 같은 포장지로 대화한다.

그래서 흐름이 늘 똑같다. URL+메서드로 묻고 JSON으로 받는다. API의 90%는 이 한 줄로 설명된다.

직접 호출해보기

오른쪽에서 직접 불러 본다. 창구를 고르고 버튼을 누르면 JSON이 온다.

날씨 가져오기는 GET, 관심 도시 등록은 POST다. 창구를 고르면 실제로 보낼 메서드 + URL이 만들어진다.

요청을 보내면 멀리 있는 서버까지 갔다 오느라 잠깐 걸린다. 그러고 나면 200 OK 상태와 함께 JSON 응답이 떨어진다.

같은 창구라도 보낸 값이 다르면 답이 달라진다. 우리가 쓰는 앱이 매 순간 하는 일이다. 끊임없이 묻고, JSON으로 받는다.

// 날씨 API에 GET 요청 보내고 JSON 받기
const res = await fetch(
  "https://api.weather.kr/weather?city=서울"
);
const data = await res.json();   // JSON → 객체로

console.log(data.temp);          // 19
console.log(data.sky);           // "맑음"

우리가 매일 쓰는 API

API는 멀리 있는 얘기가 아니다. 오늘 켠 앱 거의 다 안에서 API가 돌고 있었다.

배달 앱이 가게를 지도에 찍는 건 지도 API, 날씨 위젯 숫자는 날씨 API다. "카카오로 로그인"은 로그인 API, 결제창은 결제 API다. 다 남의 창구를 빌려 쓴 것이다.

요즘은 AI도 API로 쓴다. 챗봇한테 질문 보내고 답을 JSON으로 받는다. 우리가 방금 한 것과 똑같은 흐름이다. 창구에 묻고, JSON으로 받는다.