API 명세 설계

핵심 개념

화면과 DB가 정해지면 API를 설계합니다. 개발 전 API 명세를 작성하면 프론트와 백엔드가 동시에 작업 가능합니다.

본문

API SPECIFICATION게시글 API:GET /api/posts 목록GET /api/posts/:id 상세POST /api/posts 🔒 인증필요PUT /api/posts/:id 🔒 인증필요DELETE /api/posts/:id 🔒 인증필요Response 형태:{ data: [...], total: 100, page: 1, limit: 10 }

🛠️ 이 챕터의 실습 방법

실습 1: ERD 그리기

아래 무료 도구로 테이블 3~5개의 ERD를 그려보세요:

dbdiagram.io: https://dbdiagram.io (코드로 ERD 작성)
draw.io: https://draw.io (드래그 앤 드롭)

📋 코드 (12줄)

// dbdiagram.io 예시
Table users {
  id int [pk]
  name varchar
  email varchar [unique]
}
Table posts {
  id int [pk]
  user_id int [ref: > users.id]
  title varchar
  content text
}

실습 2: Git 워크플로우 실습

BASH📋 코드 (8줄)

# GitHub에 빈 저장소 생성 후
git clone https://github.com/유저명/프로젝트.git
cd 프로젝트
git checkout -b feature/init
# 파일 추가
git add . && git commit -m 'feat: 프로젝트 초기 설정'
git push origin feature/init
# GitHub에서 Pull Request 생성

AI 프롬프트

🤖 AI에게 잘 물어보는 법 — 모델·전략별 프롬프트

무료 모델

Gemini 2.5 Flash(무료) + Claude Sonnet 4.6(무료) + Grok 4.1(무료)

'API 명세' 기획을 0원으로 시작하고 싶어.
ChatGPT(아이디어) → Gemini(경쟁 분석) → Claude(기획서 구조화) 순서로
Notion+Figma+GitHub Projects만 사용하는 워크플로우를 설계해줘.

소자본 모델

Claude API + Cursor $20/mo + Make.com — 월 10~30만원

'API 명세' 기획에 AI를 활용해서 시간을 단축하고 싶어.
Perplexity API(시장조사) + Claude API(문서 작성) + Cursor(프로토타입) 조합으로
1주일 안에 기획→MVP까지 끝내는 월 20만원 플랜을 짜줘.

프로덕션 모델

Claude Opus + CrewAI + LangGraph — 월 100만원+

'API 명세'를 팀 프로젝트로 확장하려 해.
AI PM(Claude Opus) + AI 리서처(Perplexity) + AI 개발(Cursor+Copilot)
에이전트 팀과 AGENTS.md 협업 프로토콜을 월 100만원 예산으로 설계해줘.

스택 프롬프트

0원→$20/mo→$100/mo 단계별 스택 비교

'API 명세' 기획에 최적화된 AI 도구 조합을 단계별로 알려줘.
무료(Notion+Figma+ChatGPT) → 소자본(Cursor+Perplexity API) → 프로덕션(CrewAI+LangGraph)
각 단계별 도구·결과물·전환 시점을 비교해줘.

⭐ 이것만 기억하세요

API 명세 설계는 이 3가지만 확실히 잡으세요

1.API 명세 없이 프론트와 백엔드를 동시에 개발하면 요청·응답 형식이 안 맞아서 통합 시 충돌합니다

2.엔드포인트 URL + HTTP 메서드 + 요청 body + 응답 형식 + 상태 코드를 문서화하면 팀 간 계약이 됩니다

3.다음 챕터에서 기술 스택과 개발 일정을 확정합니다

💬 이 챕터 질문 보기

PROJECT-PLAN · CH.13 — 질문하거나 답변을 확인하세요

→

진행도 13 / 34

← 커리큘럼으로 ← 목록으로 (프로젝트 기획)