用量与错误处理
在接入前了解数据查询与广告监控的额度规则。
数据查询用量
平台现有说明中,获取一条数据结果消耗 1 数据额度;获取已有数据结果的更多详情不重复消耗数据额度。请同时查看各接口的计费或使用说明,部分操作免费或有独立规则。
打开控制台查看当前套餐与可用额度,不要假定所有接口的消耗方式相同。
广告监控
广告监控使用独立于数据查询的额度。平台文档的基础规则为每次监控 $1 / 月,单次监控有效期为一个月,到期自动停止。删除监控不会恢复监控次数。现有用量说明中,已创建的监控可随时调用,不限制调用次数。
创建任务前,请在控制台确认当前套餐和实际适用价格。
同时检查 HTTP 与业务结果
检查 HTTP 响应状态,再解析响应体中的 code 和 message。例如,Adspy 详情文档列出了以下业务错误码:
| 错误码 | 在 Adspy 详情接口中的含义 | 建议处理 |
|---|---|---|
200 | 成功 | 处理返回数据。 |
400 | 请求参数错误 | 检查包括广告 ID 在内的必填参数。 |
404 | 未找到广告 | 核对标识符,并处理数据不可用的情况。 |
500 | 服务端内部错误 | 在确认可安全重复调用时,使用退避策略重试。 |
以上为特定接口的示例,不是全平台统一错误码表。请以所选接口的错误码说明为准。
安全重试
为客户端设置超时,并处理网络故障。对于临时失败,采用有限次数的退避重试。对于创建、更新或删除监控任务的操作,确认重复调用安全后再重试。记录错误时不要记录 API Key。
获取帮助
联系支持时提供接口 URI、请求时间与响应错误码,并从示例中移除密钥和私有数据。账号与接入问题可以联系支持团队。