错误
每种拒绝响应都具有相同的结构。请根据 code 处理:它永远不会改变。message 是给人看的,可能会改变。
错误的结构
{
"error": {
"code": "insufficient_balance",
"message": "This file costs $18.00 USD but your balance is $4.50 USD. Please add funds.",
"request_id": "req_7f3c9a12",
"docs_url": "https://docs.talismanleads.io/errors#insufficient_balance"
}
}联系客服时请提供 request_id。每个响应也会在 Request-Id 标头中携带它。
所有错误代码
API 无法理解此请求:消息中说明了原因。请修正后再发送。
POST /orders 需要有效的 Idempotency-Key 标头:最多 200 个不含空格的 ASCII 字符。列表中有一行不是该检测器接受的内容。消息中给出了示例。
此检测器要求每个文件包含更多记录。
列表过长:请求中最多 100,000 条,上传最多 10,000,000 条。
文件超过 200 MB。
您发送的
country 与列表中的号码不符。一个文件必须只包含来自同一国家的号码。请拆分为多个文件,每个国家一个文件。
该
upload_id 不属于您,或其文件尚未上传完成,或其文件已不存在(上传的文件会等待下单 24 小时)。如果您已用此上传下单但丢失了响应,请使用原来的幂等键重复该请求。否则,请重新上传文件并使用新的幂等键下单:旧的幂等键下没有创建任何订单。文件在计价后发生了变化。未创建任何订单。请重新上传并使用新的幂等键下单。
该价格已过旧,无法使用。请使用相同的
Idempotency-Key 重复请求。invalid_key
401API 密钥缺失、错误,或不是我们签发的。
revoked_key
401此 API 密钥已被吊销。请使用其他 API 密钥。
expired_key
401此 API 密钥已过期。请创建新的 API 密钥。
您的余额不足以支付此订单。请充值,然后使用相同的幂等键重复下单。
key_blocked
403此 API 密钥已被封禁。请联系客服。
此 API 密钥只能从其他 IP 地址使用。
此账户不能使用 API。请联系客服。
此账户的 API 访问已关闭。网站仍可正常使用。请联系客服。
此 API 密钥为只读,而此调用需要可以下单的 API 密钥。
此检测器目前未向您的账户开放。请参阅
GET /checkers。您的地址已被封禁。请联系客服。
not_found
404此账户下没有该订单或接口。
此幂等键已用于另一个不同的请求。新订单请使用新的幂等键。
价格与您预期的不同,或自该幂等键首次发送以来已变动。未创建任何订单。请使用新的幂等键按新价格下单。
请求超过 4 MB。大型列表请使用
POST /uploads。您等待中的上传过多(20 个文件或 100 MB),或今天的上传次数过多(500 次)。请用其中一个下单,或稍后再试:上传的文件会在 24 小时后被删除。
rate_limited
429您已超过速率限制。请等待
Retry-After 中的秒数。如果是下单,请使用相同的幂等键重复。请参阅速率限制。您未完成的订单过多。请等待
Retry-After 中的秒数,然后使用相同的幂等键重复下单。我们这边出了问题。对于
POST /orders,订单可能已经提交成功,因此请使用相同的 Idempotency-Key 重复请求:这绝不会重复扣费。对于其他调用,请重试,或携带 request_id 联系客服。api_disabled
503API 目前已关闭。请稍后再试。如果是下单,请使用相同的幂等键重复。
API 目前无法响应。请等待一分钟,然后使用相同的幂等键重复请求。
我们无法确认该订单。请使用相同的
Idempotency-Key 重复请求以了解其真实状态:这绝不会重复扣费。如果持续返回此错误超过几分钟,请停止重试,并携带 request_id 联系客服。不要生成新的幂等键。