냅다 바이브코딩하면서 개발지식 익히기
API
프로그램 간의 데이터, 기능 등을 소통하기 위한 규칙
얻어갈 것
- API 요청이 클라이언트, 서버 사이에서 어떻게 오가는지 이해합니다.
- REST API가 무엇인지 알아봅니다.
API란
API는 프로그램과 프로그램이 정해진 규칙으로 대화하게 해주는 통로입니다. 앞 레슨의 표현으로 말하면, 프론트엔드가 백엔드에 기능이나 데이터를 요청할 때 쓰는 약속입니다.
처음에는 API를 “서버로 들어가는 정해진 문”처럼 생각하면 쉽습니다. 클라이언트는 그 문으로 필요한 일을 요청하고, 서버는 약속된 형식으로 결과를 돌려줍니다.
| 흐름 | 먼저 볼 것 | 예시 |
|---|---|---|
| 클라이언트 | 어떤 기능이나 데이터가 필요한가 | 랭킹 목록이 필요합니다 |
| API | 어느 주소와 규칙으로 요청하나 | GET /api/scores |
| 서버 | 요청을 처리하고 무엇을 돌려주나 | 점수 목록, 저장 성공 여부 |
| 응답 | 화면이나 로직에 쓸 값이 무엇인가 | { rank: 3 } 같은 데이터 |
어디서 API가 필요해지나
서비스에 “화면만 보여주기”를 넘어서는 기능이 붙으면 API가 등장합니다.
- 테트리스 점수 저장: 게임 코드가 서버에 점수를 보내고, 서버는 저장 결과를 돌려줍니다.
- 랭킹 조회: 화면은 랭킹 목록 데이터를 받아 표나 리스트로 그립니다.
- 날씨 데이터 조회: 앱이 외부 API에 지역 정보를 보내고, 온도와 날씨 데이터를 받아옵니다.
- 로그인, 회원가입, 게시글 저장처럼 백엔드 기능을 호출하는 장면도 API로 설명할 수 있습니다.
API 문서 살펴보기
API 문서는 클라이언트가 어떤 요청을 보내고 어떤 응답을 받는지 정리해 둔 설명서입니다.
- 프로토콜과는 다릅니다. 프로토콜은 통신 규칙이고, API는 그 프로토콜(보통 HTTP) 위에서 "이렇게 요청하면 이렇게 응답한다"를 정해둔 약속입니다.
- 그래서 대부분의 API 문서는 HTTP의
endpoint,method,header같은 표준을 그대로 따릅니다. - 결국 문서에서 볼 건 두 가지입니다 — 요청(어디로·어떻게·무엇을)과 응답(무엇이 돌아오는지).
대표적으로 카카오 로그인 API 문서를 보면 요청과 응답 설명을 확인할 수 있습니다.
REST API는 자주 보는 패턴입니다
REST API는 API를 설계하는 대표적인 스타일 중 하나로 많은 서버에서 REST API 표준에 맞춰 API를 설계합니다.
지금 단계에서 정의를 깊게 외울 필요는 없습니다. URL은 자원을 가리키고, method는 행동을 가리킨다고 먼저 잡으면 됩니다.
| 요청 | 읽는 법 |
|---|---|
GET /posts | 글 목록을 가져옵니다 |
POST /posts | 새 글을 만듭니다 |
GET /posts/123 | 123번 글 하나를 가져옵니다 |
PATCH /posts/123 | 123번 글 일부를 수정합니다 |
DELETE /posts/123 | 123번 글을 삭제합니다 |
실제 서비스마다 예외는 있습니다. 그래도 이 패턴을 알고 있으면 AI가 만든 코드나 API 문서를 볼 때 “어떤 자원에 어떤 행동을 하는 요청인지”를 훨씬 빨리 읽을 수 있습니다.
마무리
API는 프로그램끼리 기능과 데이터를 주고받는 약속입니다. 클라이언트가 필요한 일을 요청하고, 서버가 결과를 돌려주는 구조만 잡아도 API 문서와 호출 코드를 훨씬 덜 낯설게 읽을 수 있습니다.
다음 레슨에서는 API가 가져오거나 저장하는 데이터가 어디에 쌓이는지, 즉 데이터베이스를 살펴봅니다.