Article Management
CRUD interfaces for managing articles.
Get Article List
Get article list for backend management (including drafts).
Interface Information
- Endpoint:
GET /api/admin/articles - Authentication: Required (admin permission)
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| page | number | No | Page number, default 1 |
| limit | number | No | Items per page, default 10 |
| status | string | No | Status filter: published/draft |
| keyword | string | No | Keyword search |
Create Article
Create new article.
Interface Information
- Endpoint:
POST /api/admin/articles - Authentication: Required (admin permission)
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| title | string | Yes | Article title |
| content | string | Yes | Article content (Markdown) |
| categoryId | number | Yes | Category ID |
| excerpt | string | No | Article excerpt |
| coverImage | string | No | Cover image URL |
| status | string | No | Status: published/draft, default draft |
Request Example
bash
curl -X POST http://localhost:3000/api/admin/articles \
-H "Authorization: Bearer your-jwt-token" \
-H "Content-Type: application/json" \
-d '{
"title": "My New Article",
"content": "# Article Content\n\n...",
"categoryId": 1,
"status": "published"
}'Update Article
Update existing article.
Interface Information
- Endpoint:
PUT /api/admin/articles/:id - Authentication: Required (admin permission)
Request Parameters
Same as create article, all fields optional.
Request Example
bash
curl -X PUT http://localhost:3000/api/admin/articles/1 \
-H "Authorization: Bearer your-jwt-token" \
-H "Content-Type: application/json" \
-d '{
"title": "Updated Title",
"status": "published"
}'Delete Article
Delete specified article.
Interface Information
- Endpoint:
DELETE /api/admin/articles/:id - Authentication: Required (admin permission)
Request Example
bash
curl -X DELETE http://localhost:3000/api/admin/articles/1 \
-H "Authorization: Bearer your-jwt-token"Error Responses
| HTTP Status Code | Description |
|---|---|
| 401 | Not logged in or token invalid |
| 403 | Insufficient permission (non-admin) |
| 404 | Article does not exist |
| 400 | Parameter error |
| 500 | Server error |