如何使用 xaicms 的 API 接口？

FAQ答

使用 xaicms API 可按以下步骤进行：<ol><li>准备连接信息：确认网站的 <code>XAICMS_BASE_URL</code>，并由管理员获取 <code>CMS_MANAGER_TOKEN</code>。基础地址不要包含 <code>/api/cms-manager/v1</code>。</li><li>安全保存 Token：将 Token 存入本机环境变量或密钥管理器，不要写入聊天、前端代码、源码、JSON 或 Markdown。</li><li>添加鉴权：所有请求携带 <code>Authorization: Bearer <CMS_MANAGER_TOKEN></code> 和 <code>Accept: application/json</code>；POST、PUT 还需设置 <code>Content-Type: application/json</code>。</li><li>验证连接：先请求 <code>GET {XAICMS_BASE_URL}/api/cms-manager/v1/health</code>。返回 <code>{"status":"ok","cms":"xaicms-next"}</code> 表示地址和 Token 可用。</li><li>调用资源：通过 <code>/categories</code>、<code>/posts</code>、<code>/page-templates</code> 和 <code>/single-pages</code> 管理栏目、文章、模板与单页。创建文章前先读取栏目 ID；创建单页前先读取模板字段。</li><li>谨慎写入：文章默认使用 <code>draft</code>。更新或删除前先读取目标资源并核对网站、ID 和标题；发布和永久删除应取得人工明确确认。</li></ol>示例：<code>curl -H "Authorization: Bearer $CMS_MANAGER_TOKEN" -H "Accept: application/json" "$XAICMS_BASE_URL/api/cms-manager/v1/health"</code>常见状态码：<code>400</code> 参数错误，<code>401</code> Token 缺失或无效，<code>403</code> 许可证或权限限制，<code>404</code> 资源不存在，<code>503</code> 服务端未配置管理 Token。

如何使用 xaicms 的 API 接口？

FAQ问

FAQ答

开始提交表单