Pipispy APIEnglish

用量与错误处理

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

数据查询用量

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

打开控制台查看当前套餐与可用额度,不要假定所有接口的消耗方式相同。

广告监控

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

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

同时检查 HTTP 与业务结果

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

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

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

安全重试

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

获取帮助

联系支持时提供接口 URI、请求时间与响应错误码,并从示例中移除密钥和私有数据。账号与接入问题可以联系支持团队。