From 108265b1fde0d2aedc1d0dc20b49e78b0b06fc82 Mon Sep 17 00:00:00 2001
From: caadiq <caadiq@gmail.com>
Date: Sun, 18 Jan 2026 23:48:21 +0900
Subject: [PATCH] =?UTF-8?q?docs:=20=EB=B4=87=20=EA=B4=80=EB=A6=AC=20API=20?=
 =?UTF-8?q?=EB=AC=B8=EC=84=9C=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- GET /admin/bots: 봇 목록 조회
- POST /admin/bots/:id/start: 봇 시작
- POST /admin/bots/:id/stop: 봇 정지
- POST /admin/bots/:id/sync-all: 전체 동기화
- GET/DELETE /admin/bots/quota-warning: 할당량 경고

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

diff --git a/docs/api.md b/docs/api.md
index 2c431eb..f515af6 100644
--- a/docs/api.md
+++ b/docs/api.md
@@ -117,10 +117,61 @@ Meilisearch 전체 동기화 (인증 필요)
 
 ---
 
-## 봇 상태
+## 관리자 - 봇 관리 (인증 필요)
 
-### GET /bots
-봇 상태 조회
+### GET /admin/bots
+봇 목록 조회
+
+**응답:**
+```json
+[
+  {
+    "id": "youtube-fromis9",
+    "name": "fromis_9",
+    "type": "youtube",
+    "status": "running",
+    "last_check_at": "2026-01-18T10:30:00Z",
+    "last_added_count": 2,
+    "schedules_added": 150,
+    "check_interval": 2,
+    "error_message": null,
+    "enabled": true
+  }
+]
+```
+
+### POST /admin/bots/:id/start
+봇 시작
+
+### POST /admin/bots/:id/stop
+봇 정지
+
+### POST /admin/bots/:id/sync-all
+전체 동기화 (모든 영상/트윗 수집)
+
+**응답:**
+```json
+{
+  "success": true,
+  "addedCount": 25,
+  "total": 100
+}
+```
+
+### GET /admin/bots/quota-warning
+YouTube API 할당량 경고 조회
+
+**응답:**
+```json
+{
+  "active": true,
+  "message": "YouTube API 할당량 초과",
+  "timestamp": "2026-01-18T10:00:00Z"
+}
+```
+
+### DELETE /admin/bots/quota-warning
+할당량 경고 해제
 
 ---