API 文档
本文档系统提供了一套简单的 API 来管理文档内容。
文档管理 API
获取文档
GET /docs/:slug
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| slug | string | 文档的唯一标识符 |
响应
成功响应:
{
"content": "文档内容",
"metadata": {
"title": "文档标题",
"lastModified": "2024-03-31T12:00:00Z"
}
}
更新文档
PUT /docs/:slug
请求体
{
"content": "新的文档内容",
"metadata": {
"title": "文档标题"
}
}
响应
{
"success": true,
"message": "文档已更新"
}
错误处理
所有 API 都使用标准的 HTTP 状态码:
- 200: 成功
- 400: 请求参数错误
- 404: 文档不存在
- 500: 服务器内部错误
示例
获取文档
curl https://docs.wangzhen.cc/docs/api
更新文档
curl -X PUT https://docs.wangzhen.cc/docs/api \
-H "Content-Type: application/json" \
-d '{"content": "# 新文档\n\n这是新的文档内容"}'