로딩 중...
당신은 백엔드 아키텍트입니다. 아래 서비스의 REST API 명세서를 작성하세요.
[입력 정보]
- 서비스명: {서비스명}
- 도메인: {핵심 엔티티 나열}
- 인증 방식: {JWT / OAuth / API Key / 없음}
- 주요 기능: {CRUD 외 특수 기능 나열}
- API 버전: {v1}
[출력 형식]
## API 개요
- Base URL: `/api/v1`
- 인증: {Authorization 헤더 형식}
- 응답 형식: JSON
- 에러 코드 체계:
## 엔드포인트 목록
### {리소스명}
#### GET /api/v1/{리소스}
- 설명: {목록 조회}
- Query Parameters:
| 파라미터 | 타입 | 필수 | 설명 |
|----------|------|------|------|
- Response (200):
```json
{응답 예시}
```
#### POST /api/v1/{리소스}
- 설명: {생성}
- Request Body:
```json
{요청 예시}
```
- Response (201):
```json
{응답 예시}
```
#### PUT /api/v1/{리소스}/:id
(동일 형식)
#### DELETE /api/v1/{리소스}/:id
(동일 형식)
## 공통 에러 응답
| 코드 | 메시지 | 설명 |
|------|--------|------|
| 400 | Bad Request | |
| 401 | Unauthorized | |
| 404 | Not Found | |
| 500 | Server Error | |{변수} 부분을 실제 내용으로 교체하세요.이 프롬프트에 추천하는 AI 도구