From 4c0419649b82d06facbacd2c7c352f6cc969e941 Mon Sep 17 00:00:00 2001
From: Wang Zhuoxuan <wangzhuoxuan210@gmail.com>
Date: Sat, 11 Apr 2026 12:57:24 +0800
Subject: [PATCH] docs: update admin categories API with pagination parameters
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Add page/limit query parameters documentation
- Update response format to include pagination metadata
- Specify parameter constraints (page ≥ 1, limit 1-50)

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

diff --git a/docs/api-reference.md b/docs/api-reference.md
index 5c512b9..b3b069e 100644
--- a/docs/api-reference.md
+++ b/docs/api-reference.md
@@ -931,10 +931,14 @@
 
 #### GET /admin/categories
 
-获取所有分类。
+获取分类列表。
 
 **认证**: Admin Token
 
+**查询参数**:
+- `page`: 页码 (默认: 1, 必须 ≥ 1)
+- `limit`: 每页数量 (默认: 20, 范围: 1-50)
+
 **响应**:
 ```json
 {
@@ -946,9 +950,15 @@
       "slug": "history",
       "parentId": null,
       "sortOrder": 1,
+      "questionCount": 120,
       "status": "active"
     }
   ],
+  "pagination": {
+    "total": 45,
+    "page": 1,
+    "limit": 20
+  },
   "error": null
 }
 ```