# 用量与错误处理

在接入前了解数据查询与广告监控的额度规则。

## 数据查询用量

平台现有说明中，获取一条数据结果消耗 1 数据额度；获取已有数据结果的更多详情不重复消耗数据额度。请同时查看各接口的计费或使用说明，部分操作免费或有独立规则。

[打开控制台](/zh/dashboard)查看当前套餐与可用额度，不要假定所有接口的消耗方式相同。

## 广告监控

广告监控使用独立于数据查询的额度。平台文档的基础规则为每次监控 $1 / 月，单次监控有效期为一个月，到期自动停止。删除监控不会恢复监控次数。现有用量说明中，已创建的监控可随时调用，不限制调用次数。

创建任务前，请在控制台确认当前套餐和实际适用价格。

## 同时检查 HTTP 与业务结果

检查 HTTP 响应状态，再解析响应体中的 `code` 和 `message`。例如，Adspy 详情文档列出了以下业务错误码：

| 错误码 | 在 Adspy 详情接口中的含义 | 建议处理 |
| --- | --- | --- |
| 200 | 成功 | 处理返回数据。 |
| 400 | 请求参数错误 | 检查包括广告 ID 在内的必填参数。 |
| 404 | 未找到广告 | 核对标识符，并处理数据不可用的情况。 |
| 500 | 服务端内部错误 | 在确认可安全重复调用时，使用退避策略重试。 |

以上为特定接口的示例，不是全平台统一错误码表。请以所选接口的错误码说明为准。

## 安全重试

为客户端设置超时，并处理网络故障。对于临时失败，采用有限次数的退避重试。对于创建、更新或删除监控任务的操作，确认重复调用安全后再重试。记录错误时不要记录 API Key。

## 获取帮助

联系支持时提供接口 URI、请求时间与响应错误码，并从示例中移除密钥和私有数据。账号与接入问题可以[联系支持团队](https://wa.me/+4407734432780)。