/api-docs — API 문서 자동 생성

---
description: 라우트 핸들러 코드를 읽고 엔드포인트, 파라미터, 응답 형식, 에러 케이스가 포함된 API 문서를 생성합니다.
---

# /api-docs

## 절차

1. 대상 라우트/컨트롤러 파일을 읽고 실제 코드에서 다음을 추출합니다 (문서 주석이 아니라 코드 기준):
   - HTTP 메서드와 경로
   - 요청 파라미터(경로/쿼리/바디)와 필수 여부, 타입
   - 인증/권한 요구사항 (미들웨어, 데코레이터 등에서 확인)
   - 성공 응답의 실제 형태