프로그래밍이나 웹사이트를 공부하다 보면 ‘API’라는 단어를 정말 많이 보게 된다. 특히 날씨 앱, 로그인 기능, 지도 기능, 결제 기능 같은 이야기를 할 때 거의 빠지지 않는다.
하지만 처음에는 API가 정확히 무엇인지 이해하기 어렵다. 이름도 어렵고, 설명을 찾아보면 “Application Programming Interface” 같은 말만 나와서 더 헷갈린다.
나도 처음에는 API가 어떤 특별한 프로그램 이름인 줄 알았다. 그런데 직접 웹사이트를 만들고, 다른 서비스의 데이터를 가져와보면서 API는 프로그램 자체가 아니라, 프로그램끼리 서로 대화하는 방법이라는 것을 알게 됐다.
결론부터 말하면, API는 한 프로그램이 다른 프로그램에게 “이 기능을 써도 될까?” 하고 요청하는 방법이다.
쉽게 말하면 API는 두 프로그램 사이의 메뉴판이자 대화 규칙이다.
API는 왜 필요한 걸까
예를 들어 내가 날씨 앱을 만든다고 해보자. 그런데 내 앱 안에는 실제 날씨 정보가 없다. 오늘 서울의 기온이나 비가 오는지 알려면, 이미 날씨 정보를 가지고 있는 다른 회사의 서버에게 물어봐야 한다.
이때 내가 서버 안으로 직접 들어가서 데이터를 뒤지는 것은 불가능하다. 대신 정해진 방식으로 요청해야 한다.
예를 들어 아래처럼 “서울 날씨 알려줘”라고 요청하는 규칙이 있을 수 있다.
https://weather.example.com/api/today?city=Seoul
그러면 서버는 아래처럼 답을 보내준다.
{ "temperature": 19, "weather": "맑음" }
이런 요청과 응답 방식 전체를 API라고 부른다.
즉, API는 “다른 프로그램에게 필요한 정보를 부탁하는 방법”이다.
쉽게 비유하면 API는 식당의 메뉴판과 같다. 손님은 주방에 직접 들어가서 요리를 만들지 않는다. 대신 메뉴판을 보고 “김치찌개 주세요”라고 말한다. 그러면 식당은 정해진 방식대로 음식을 만들어서 준다.
여기서:
- 손님 = 내 프로그램
- 주방 = 다른 회사의 서버
- 메뉴판 = API
즉, API는 “어떤 요청을 할 수 있는지 알려주는 설명서”라고 생각하면 쉽다.
API는 어디에 사용될까
생각보다 우리가 사용하는 거의 모든 앱과 웹사이트는 API를 사용하고 있다.
예를 들어 아래 같은 기능도 전부 API를 사용한다.
- 날씨 앱에서 오늘 날씨 보기
- 지도 앱에서 길찾기 하기
- 쇼핑몰에서 카카오페이 결제하기
- 로그인할 때 네이버 로그인, 구글 로그인 사용하기
- 유튜브 영상 목록 불러오기
예를 들어 어떤 쇼핑몰 사이트에서 “카카오로 로그인” 버튼을 누른다고 해보자. 그러면 그 사이트는 카카오의 API를 사용해서 로그인 정보를 받아온다.
즉, 웹사이트가 모든 기능을 직접 만들지 않아도, 다른 회사의 API를 연결하면 훨씬 쉽게 기능을 추가할 수 있다.
나도 처음에는 날씨 앱을 만들려면 날씨 데이터를 직접 모아야 하는 줄 알았다. 그런데 실제로는 날씨 API를 연결하면 몇 줄 코드만으로 오늘 날씨를 가져올 수 있다는 것을 알고 꽤 신기했다.
API는 어떻게 요청하고 답을 받을까
API는 보통 인터넷 주소처럼 생긴 URL로 요청한다.
예를 들어 아래처럼 요청할 수 있다.
https://api.example.com/user/123
이 주소는 “123번 사용자의 정보를 주세요”라는 뜻일 수 있다.
그러면 서버는 아래처럼 답을 준다.
{
"name": "Mary",
"age": 22
}
즉, API는 요청을 보내면, 서버가 결과를 보내주는 방식이다.
보통은 아래 순서로 작동한다.
- 프로그램이 API 주소로 요청한다.
- 서버가 요청 내용을 확인한다.
- 서버가 필요한 데이터를 찾는다.
- 결과를 다시 보내준다.
이 과정을 보면 API는 서버와 대화하는 통로라는 것을 알 수 있다.
GET, POST는 무엇일까
API를 공부하다 보면 GET, POST라는 말을 자주 보게 된다. 이것도 처음에는 어려워 보이지만, 사실은 요청의 종류를 뜻한다.
GET은 “정보를 가져와 주세요”라는 요청이다.
예를 들어:
GET /weather
이것은 날씨 정보를 보여달라는 뜻이다.
반면 POST는 “새로운 정보를 저장해 주세요”라는 요청이다.
예를 들어 회원가입을 할 때는 아래처럼 POST를 사용한다.
POST /signup
즉, 사용자가 입력한 이름과 이메일을 서버에 저장해달라는 뜻이다.
쉽게 정리하면:
| 요청 방식 | 뜻 | 예시 |
|---|---|---|
| GET | 정보 가져오기 | 날씨 보기, 게시물 보기 |
| POST | 정보 저장하기 | 회원가입, 댓글 작성 |
실제로는 PUT, DELETE 같은 방식도 있지만, 초보자는 GET과 POST만 먼저 알아도 충분하다.
API와 서버는 무엇이 다를까
많은 사람이 API와 서버를 같은 것으로 생각한다. 하지만 둘은 다르다.
서버는 실제로 데이터를 저장하고 처리하는 컴퓨터다. API는 그 서버에게 요청하는 방법이다.
예를 들어 쇼핑몰 서버가 있다고 해보자. 그 안에는 여러 API가 있을 수 있다.
- /login → 로그인 API
- /product → 상품 목록 API
- /order → 주문 API
즉, 서버는 실제로 일을 하는 공간이고, API는 그 서버 안에 있는 여러 “입구” 같은 것이다.
쉽게 비유하면:
- 서버 = 식당 주방
- API = 메뉴판과 주문 방법
주방은 실제로 음식을 만들고, 메뉴판은 어떤 음식을 주문할 수 있는지 알려준다.
나도 처음에는 “API 서버”라는 말을 보고 API와 서버가 같은 뜻인 줄 알았다. 그런데 실제로는 서버 안에 여러 API가 들어 있다는 것을 알고 나서 훨씬 이해하기 쉬워졌다.
API를 사용하면 왜 편할까
API의 가장 큰 장점은, 다른 사람이 이미 만들어둔 기능을 쉽게 가져다 쓸 수 있다는 것이다.
예를 들어 내가 지도를 직접 만들려면:
- 도로 데이터 모으기
- 지도 화면 만들기
- 위치 찾기 기능 만들기
이 모든 것을 직접 해야 한다.
하지만 Google Maps API를 사용하면, 이미 만들어진 지도를 몇 줄 코드로 웹사이트에 넣을 수 있다.
마찬가지로 결제 기능도 카카오페이 API, 토스 API를 사용하면 직접 결제 시스템을 만들지 않아도 된다.
즉, API를 사용하면 다른 서비스의 기능을 내 프로그램 안에서 바로 사용할 수 있다.
그래서 요즘 프로그래밍은 “모든 것을 처음부터 직접 만드는 것”보다, 필요한 API를 잘 연결하는 능력이 훨씬 중요해지고 있다.
초보자는 API를 어떻게 이해하면 가장 쉬울까
처음에는 API라는 단어 자체가 너무 어렵게 느껴질 수 있다. 하지만 아래처럼 생각하면 가장 쉽다.
“API는 다른 프로그램에게 부탁하는 방법”
예를 들어:
- 날씨 API → 날씨 알려줘
- 지도 API → 위치 보여줘
- 로그인 API → 이 사람이 맞는지 확인해줘
즉, API는 다른 프로그램의 기능을 빌려 쓰는 통로다.
그리고 그 요청은 정해진 규칙대로 해야 한다. 식당에서 메뉴판에 없는 음식을 주문할 수 없는 것처럼, API도 정해진 형식으로만 요청할 수 있다.
API는 프로그램끼리 대화하게 해주는 도구다
정리하면 API는 프로그램과 프로그램이 서로 대화하고, 기능을 주고받을 수 있게 해주는 방법이다.
우리가 평소 사용하는 앱과 웹사이트도 대부분 API 덕분에 움직인다. 로그인, 지도, 결제, 날씨, 유튜브 영상, 댓글, 게시물까지 거의 모든 기능이 API를 통해 연결된다.
처음에는 이름이 어렵고 복잡해 보여도, 결국 API는 “다른 프로그램에게 필요한 것을 부탁하는 방법”일 뿐이다.
그래서 앞으로 프로그래밍을 하다가 API라는 단어를 보더라도, “아, 이건 다른 프로그램과 대화하는 통로구나”라고 생각하면 훨씬 이해하기 쉬워질 것이다.