跳至正文

支持

解决 NumDetect 账号或 API 问题

先根据错误码或受影响流程执行建议检查;只有文档步骤仍无法解决时,再联系支持。

账号恢复

使用账号电话号码重置密码,重新登录后再检查余额、历史记录或 API Key。

重置密码

API 请求参考

检查 X-API-Key、所选批量产品码、上传文件、任务响应结构和公开错误码。

查看接口约定

付款与余额

提交付款咨询前,先核对到账余额、任务扣费、支付方式和失败自动退款规则。

查看价格与计费

错误处理

遇到不同 API 错误时应该怎么做?

请同时查看 HTTP 状态和响应 code;向支持团队提供响应前应删除所有密钥。

状态 / code含义下一步
401 / 40100缺少 API Key 或密钥无效。发送 X-API-Key,确认复制的是有效密钥;如果原密钥已不可用,请在设置中创建新密钥。
402 / 40200余额不足以提交此批量任务。核对产品价格和可用余额后充值,或上传更小的文件。
429 / 42901该账号正在提交或处理的批量任务已达到上限。按 Retry-After 的秒数等待,待进行中的任务结束后再提交文件;被拒绝的请求不扣费。
503 / 50303平台当前的批量任务处理容量已满。按 Retry-After 的秒数等待后重新提交文件;未扣费。
400 / 40000批量任务的文件没通过预检:为空、格式不对、少于 1,000 个的起批量、超过 100,000 个的上限,或含有按所选国家解析无效的号码。按错误提示改文件后重新提交。预检发生在扣费之前,这次没有产生任何费用。
409 / 40901任务还没跑完,或结果链接暂时取不到。等待任务成功后,从任务页下载结果文件,或再次查询任务。
504 / 50400批量任务未在 300 秒超时限制内完成。重新提交整份文件;超时任务会全额退款。
503 / 50300批量任务服务暂时不可用或处于维护状态。不要把文件视为已处理;请稍后再次提交,失败任务会退款。

联系支持前

附上能定位请求的关键信息

提供这些上下文能缩短排查时间,且无需提供密码或 API Key 明文。

  1. 账号工作区关联的电话号码。
  2. 请求批量任务 ID、所选产品码和大致提交时间。
  3. 响应API 错误码与提示信息(请去除敏感信息)。

更快处理的检查清单

账号和 API 问题通常在提供账号电话号码、批量任务 ID、产品码、请求时间和脱敏响应体后,可以更快定位。

联系我们: support@numdetect.com