API 란 무엇인가요?
서버가 할 수 있는 일의 메뉴
⏱ 예상 ~4분
01 · 읽기
API (Application Programming Interface, 응용 프로그램 인터페이스) 는 서버가 어떤 요청을 받을지, 어떤 응답을 돌려보낼지 정해두는 규칙 모음이에요.
개발자가 server 를 만들 때, 아무 요청이나 막 받게 두지 않아요. 호출할 수 있는 endpoint (URL), 보낼 데이터, 돌려받을 결과를 적은 분명한 목록 — 그게 API 예요.
여러분이 쓰는 모든 앱이 API 에 기대고 있어요. 날씨 앱이 예보를 보여줄 때, 날씨 API 를 호출해요. 웹사이트에 로그인할 때, 인증 API 를 호출해요. SNS 피드를 내릴 때, 다음 게시물 묶음을 가져오는 API 를 호출해요.
💡 상상해 봐요API 는 음식점 메뉴와 같아요. 메뉴는 무엇을 주문할 수 있는지, 각 요리에 무엇이 들어 있는지, 가격이 얼마인지 알려줘요. 주방에 들어가서 마음대로 만들 수는 없어요 — 메뉴에서 골라야 해요. API 도 그래요. 여러분의 앱이 서버에게 무엇을 요청할 수 있는지 알려주는 거예요.
핵심 정리
- API = Application Programming Interface
- 서버가 받아들이는 요청의 "메뉴"를 정의해요
- 메뉴의 각 항목을 endpoint 라고 해요 (특정 URL + method 의 조합)
- API 덕분에 서로 다른 소프트웨어 시스템이 내부 세부 사항을 몰라도 통신할 수 있어요
02 · 코드 예제
아래는 블로그의 전형적인 API 가 어떻게 생겼는지 보여줘요. 각 endpoint 는 HTTP method 와 URL 경로의 조합이에요.
Blog API Endpoints
GET /api/posts → Get all blog posts
GET /api/posts/15 → Get post #15
POST /api/posts → Create a new post
PUT /api/posts/15 → Update post #15
DELETE /api/posts/15 → Delete post #15
User API Endpoints
GET /api/users → Get all users
GET /api/users/42 → Get user #42's profile
POST /api/users → Create a new user (sign up)
PUT /api/users/42 → Update user #42's profile
DELETE /api/users/42 → Delete user #42's account
패턴에 주목하세요. URL 은 무엇을 다루는지 ( /posts 인지 /users 인지) 알려주고, 숫자는 어느 항목인지 알려주고, HTTP method 는 무엇을 하고 싶은지 알려줘요. 이런 일관된 패턴 덕분에 API 가 짐작하기 쉽고 쓰기 좋아요.
03 · 퀴즈
모바일 날씨 앱이 오늘 예보를 보여줘요. 그 데이터를 어떻게 가져오는 걸까요?
- 예보 데이터가 앱 안에 박혀 있어요
- 앱이 휴대폰 센서에서 데이터를 읽어요
- 앱이 날씨 API 를 호출해 최신 데이터를 가져와요
- 앱이 날씨 웹사이트를 크롤링해요
04 · 빈칸 채우기
API 는 서버가 받아들일 _____ 를 정의해요.
⚠ 전체 인터랙티브 경험에는 JavaScript가 필요해요. JavaScript를 켜고 새로 고침해 주세요.
※ 이 사이트는 독립 운영되는 교육 프로젝트로, Anthropic의 공식 제품이 아니에요. Claude™ 는 Anthropic, PBC 의 상표예요.