访问凭证

访问令牌

除特别说明外，每个接口都需要以下请求头：

Authorization: Bearer YOUR_TOKEN

访问令牌由对接人员提供。请只在服务端保存，通过密钥管理系统或环境变量读取；不要写入网页代码、Git、日志或工单。

如果令牌缺失、过期或无效，接口返回 HTTP 401。

防重复提交标识

创建监测任务时必须额外提供：

Idempotency-Key: monitor-request-20260812-0001

这个值用于避免网络超时或断线重试时重复创建任务：

• 同一次提交重试：复用原值。
• 提交一批新任务：生成新值。
• 长度必须为 8–160 个字符。
• 同一个值不能对应两份不同的请求内容。

推荐使用业务订单号或 UUID，并在客户端保存提交记录。

排查请求问题

服务响应会包含 X-Request-ID。联系支持时，请提供该编号、请求时间和接口地址，不要提供真实访问令牌或完整问题正文。