From 8bcd3e881dc342eb86a4f293861a185958e5958a Mon Sep 17 00:00:00 2001
From: caadiq <caadiq@gmail.com>
Date: Tue, 20 Jan 2026 17:28:50 +0900
Subject: [PATCH] =?UTF-8?q?docs:=20API=20=EB=AC=B8=EC=84=9C=20=EC=97=85?=
 =?UTF-8?q?=EB=8D=B0=EC=9D=B4=ED=8A=B8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- GET /schedules에 startDate 파라미터 추가
- 다가오는 일정 조회 응답 형식 문서화
- PUT /admin/youtube/schedule/:id 문서 추가

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 docs/api.md | 34 +++++++++++++++++++++++++++++++++-
 1 file changed, 33 insertions(+), 1 deletion(-)

diff --git a/docs/api.md b/docs/api.md
index c8aeb22..967f4b9 100644
--- a/docs/api.md
+++ b/docs/api.md
@@ -38,10 +38,13 @@ Base URL: `/api`
 일정 조회
 
 **Query Parameters:**
-- `year`, `month` - 월별 조회 (필수, search 없을 때)
+- `year`, `month` - 월별 조회
+- `startDate` - 시작 날짜 (YYYY-MM-DD), 다가오는 일정 조회
 - `search` - 검색어 (Meilisearch 사용)
 - `offset`, `limit` - 페이징
 
+※ `search`, `startDate`, `year/month` 중 하나는 필수
+
 **월별 조회 응답:**
 ```json
 {
@@ -70,6 +73,23 @@ Base URL: `/api`
 - X (category_id=3): `{ name: "", url: "https://x.com/realfromis_9/status/..." }` (name 빈 문자열)
 - 기타 카테고리: source 없음
 
+**다가오는 일정 응답 (startDate):**
+```json
+[
+  {
+    "id": 123,
+    "title": "...",
+    "date": "2026-01-18",
+    "time": "19:00:00",
+    "category_id": 2,
+    "category_name": "유튜브",
+    "category_color": "#ff0033",
+    "members": [{ "name": "송하영" }]
+  }
+]
+```
+※ 멤버가 5명 이상이면 `[{ "name": "프로미스나인" }]` 반환
+
 **검색 응답:**
 ```json
 {
@@ -227,6 +247,18 @@ YouTube 일정 저장
 }
 ```
 
+### PUT /admin/youtube/schedule/:id
+YouTube 일정 수정 (멤버, 영상 유형)
+
+**Request Body:**
+```json
+{
+  "memberIds": [1, 2, 3],
+  "videoType": "video"
+}
+```
+※ `videoType`: "video" 또는 "shorts"
+
 ---
 
 ## 관리자 - X (인증 필요)