核心接口
业务功能核心接口文档
核心接口 #
用户管理 #
GET /api/users #
获取用户列表。
查询参数 #
| 参数 | 类型 | 说明 |
|---|---|---|
| page | integer | 页码,默认1 |
| per_page | integer | 每页数量,默认20 |
| keyword | string | 搜索关键词 |
响应示例 #
{
"code": 200,
"data": {
"items": [
{
"id": 1,
"username": "admin",
"email": "admin@example.com",
"created_at": "2024-01-15T08:30:00Z"
}
],
"total": 100,
"page": 1,
"per_page": 20
}
}
内容管理 #
POST /api/content #
创建新内容。
请求体 #
{
"title": "文章标题",
"content": "文章内容",
"category": "技术",
"tags": ["hugo", "教程"]
}
PUT /api/content/{id} #
更新指定内容。
DELETE /api/content/{id} #
删除指定内容。
错误码 #
| 错误码 | 说明 |
|---|---|
| 400 | 请求参数错误 |
| 401 | 未授权 |
| 403 | 权限不足 |
| 404 | 资源不存在 |
| 500 | 服务器内部错误 |
评论