/api

내용

[/api] API 명세 설계

아래 요구사항으로 API를 설계해줘.

① 리소스 목록과 각각의 엔드포인트
② 메서드·경로·요청/응답 예시 (JSON)
③ 상태 코드 — 성공과 각 실패 상황별로
④ 에러 응답 형식 (하나로 통일)
⑤ 페이지네이션·정렬·필터 방식
⑥ 나중에 바꾸기 어려운 결정과 그 이유

조건
• 동사를 경로에 넣지 말 것 (리소스 중심)
• 요구사항에 없는 기능을 추가하지 말 것
• 애매한 부분은 임의로 정하지 말고 물어볼 것

요구사항:
{{INPUT}}