5과5-2
API란 무엇인가
API를 식당 주문 비유로 설명하고 REST API 기초를 배웁니다
API를 식당으로 이해하기
API(Application Programming Interface)는 두 프로그램이 소통하는 방식의 규약입니다. 어렵게 들리지만 식당 비유로 이해하면 쉽습니다.
식당에서 손님은 주방에 직접 들어가지 않습니다. 메뉴판을 보고 웨이터에게 주문하면, 웨이터가 주방에 전달하고, 음식이 나옵니다.
여기서:
- 손님 = 앱/서비스 (API를 호출하는 쪽)
- 메뉴판 = API 문서 (어떤 것을 요청할 수 있는지 목록)
- 웨이터 = API (요청을 받아 처리하는 인터페이스)
- 주방 = 서버 (실제 데이터를 보유하고 처리)
- 음식 = API 응답 (요청에 대한 결과)
구글 지도를 다른 앱에 넣을 수 있는 것, 카카오 로그인을 여러 사이트에서 사용할 수 있는 것 모두 API 덕분입니다.
REST API 기초
가장 많이 쓰이는 API 방식이 REST API입니다. REST API는 4가지 행동(메서드)을 기본으로 합니다.
GET: 데이터 요청 (주문 조회)
POST: 새 데이터 생성 (새 주문 접수)
PUT/PATCH: 기존 데이터 수정 (주문 변경)
DELETE: 데이터 삭제 (주문 취소)
실제 예시로 이해해봅시다.
# REST API 예시 — 사용자 관련
GET /api/users/123 → 123번 사용자 정보 가져오기
POST /api/users → 새 사용자 등록
PUT /api/users/123 → 123번 사용자 정보 수정
DELETE /api/users/123 → 123번 사용자 삭제
# Claude Code에게 API를 설명할 때 이 형식을 활용하세요
# 예: '사용자 목록을 가져오는 GET /api/users API를 만들어줘'
# '새 게시글을 저장하는 POST /api/posts API를 만들어줘'TIP: AI에게 API를 만들어달라고 할 때 'GET /api/뭔가 API 만들어줘'처럼 REST 방식으로 요청하면 AI가 정확히 이해합니다. 그냥 '데이터 가져오는 거 만들어줘'보다 훨씬 명확합니다.
Claude API — AI를 나의 서비스에 심는 방법
Claude API를 사용하면 여러분이 만든 앱에 Claude의 AI 능력을 심을 수 있습니다. 사용자가 앱 안에서 AI와 대화하거나, 문서를 자동 분석하거나, 맞춤형 답변을 생성하는 기능을 추가할 수 있습니다.
기본 개념: 내 앱 → Claude API에 요청 전송 → Claude가 처리 → 결과를 내 앱에 반환
API 키(Key)라는 비밀번호가 필요합니다. Anthropic 콘솔(console.anthropic.com)에서 발급받을 수 있습니다. 사용량에 따라 요금이 부과되므로 API 키는 절대 공개하지 마세요.
핵심 정리
- ✓API는 두 프로그램이 소통하는 규약으로, 웨이터처럼 요청을 전달하고 결과를 반환합니다.
- ✓REST API는 GET(조회)/POST(생성)/PUT(수정)/DELETE(삭제) 4가지 행동으로 데이터를 주고받습니다.
- ✓Claude API를 사용하면 내가 만든 앱에 AI 기능을 통합할 수 있습니다.
자주 묻는 질문
API를 직접 만들어야 할까요, 다른 서비스 API를 쓰면 될까요?+
먼저 필요한 기능을 제공하는 기존 API가 있는지 확인하세요. 카카오 지도, 포트원(결제), 기상청 날씨 API처럼 잘 만들어진 외부 API를 활용하면 시간과 비용을 크게 아낄 수 있습니다. 없거나 맞지 않는 경우에만 직접 만드세요.
API 키가 유출되면 어떻게 되나요?+
다른 사람이 내 API 키로 서비스를 사용하면 요금이 내 계정으로 청구됩니다. API 키는 반드시 환경변수(.env 파일)에 저장하고, GitHub에 절대 올리지 마세요. 유출됐다면 즉시 해당 키를 폐기하고 새로 발급받으세요.