← 강의 목록으로
5과5-2

API란 무엇인가

API를 식당 주문 비유로 설명하고 REST API 기초를 배웁니다

Practice Kit

수업 후 바로 남길 결과물

5과
1

핵심 재정리

API는 두 프로그램이 소통하는 규약으로, 웨이터처럼 요청을 전달하고 결과를 반환합니다.

2

내 업무 연결

반복 업무 하나를 골라 AI에게 맡길 단위로 쪼갭니다.

3

작은 산출물

요약문, 체크리스트, 초안, 자동화 지시문 중 하나를 완성합니다.

AI에게 붙여넣을 복습 프롬프트

나는 비개발자 실무자입니다. "API란 무엇인가" 강의를 들었습니다.

내 업무 상황:
- 반복해서 시간이 걸리는 업무:
- 지금 막히는 지점:
- 오늘 30분 안에 만들고 싶은 결과물:

요청:
1. 이 강의의 핵심을 내 업무 기준으로 3줄 요약해줘.
2. 바로 실행할 수 있는 첫 작업 3개를 순서대로 정리해줘.
3. 내가 AI에게 붙여넣을 최종 프롬프트를 하나 만들어줘.
4. 결과물을 검수할 체크리스트를 5개로 만들어줘.

검수 기준

  • 오늘 만들 결과물이 한 문장으로 정리됐는가
  • AI에게 맡길 일과 사람이 판단할 일이 분리됐는가
  • 민감정보를 제거하거나 가명 처리했는가
  • 결과물을 복사해 실제 업무 파일에 붙일 수 있는가

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에 절대 올리지 마세요. 유출됐다면 즉시 해당 키를 폐기하고 새로 발급받으세요.

학습 완료

현재까지 완료: 0개

이 강의가 어떠셨나요?

← 이전 강의다음 강의 →