管理 API 访问

打开实际 API 文档

管理 API 文档位于 https://YOUR_TRACKER/api/doc，提供当前实例的端点、参数与结构。优先使用该文档，而不是其他版本示例。

获取受限密钥

在 Settings → User 查看用户 API key。集成使用独立用户，资源权限与实际工作对应，密钥保持私密。

首次请求只读验证

在 API 文档中通过要求的 api-key 头部授权，选择只读端点，检查必填参数并执行小范围请求，再与面板同一资源比较。

头部：api-key: YOUR_API_KEY
基础地址：https://YOUR_TRACKER
路径：/api/doc 文档中的一个只读端点

谨慎接入写操作

列表请求成功，不代表所有写操作均有权限。发送修改前，检查操作结构、用户权限和目标资源，并保留请求标识与脱敏错误用于诊断。

错误处理

区分未认证、权限不足、校验失败与服务暂不可用。重试要考虑具体操作，重复创建或更新可能产生额外影响。点击追踪接入使用独立的 Click API。