一、快速入门

1.1 什么是 AnQiCMS API

AnQiCMS 是一个基于 Go 语言开发的开源内容管理系统，提供了完整的 API 接口供开发者调用。API 采用 RESTful 设计风格，支持 JSON 格式的数据交互，允许开发者通过 HTTP 请求与系统进行交互，获取、创建、更新或删除内容。

1.2 API 基础概念

• API 基础路径：/api - 所有 API 请求都需要以该路径为前缀
• 认证方式：部分接口需要认证，使用 JWT Token 进行身份验证
• 请求格式：除上传文件外，所有接口均使用 JSON 格式传输数据
• 响应格式：统一使用 JSON 格式返回数据

1.3 第一个 API 调用示例

以获取文章列表为例，介绍一次完整的 API 调用流程：

GET /api/archive/list?limit=10&page=1 HTTP/1.1
Host: your-domain.com
Content-Type: application/json

成功响应：

{
  "code": 0,
  "msg": "",
  "total": 100,
  "data": [...]
}

错误处理：

{
  "code": -1,
  "msg": "API 接口未开放"
}