状态与错误

业务错误

响应	原因	处理方式
BAD_KEY	API Key 缺失或无效	检查分配的 API Key
BAD_ACTION	操作不存在、参数重复或请求格式无效	检查 action 和表单参数
BAD_SERVICE	服务代码不支持	使用 service=ot
NO_NUMBERS	当前没有可分配号码，或国家不支持	使用 country=4，稍后重试
NO_ACTIVATION	接码 ID 无效或属于其他 Key	使用当前 Key 申请返回的 ID
BAD_STATUS	状态不支持，或请求已结束	检查操作；需要继续接码时重新申请
ERROR_SQL	服务处理失败	稍后重试状态查询，持续失败时联系管理员

请求处理

• 使用 HTTPS；业务错误仍可能返回 HTTP 200，应检查响应正文。
• 查询状态时使用不短于 3 秒的间隔，遇到网络错误逐步延长重试间隔。
• getNumber 会创建接码请求。请求超时时不要连续快速重试，未结束请求最长在 20 分钟后释放。
• 每个参数只传递一次。POST 请求使用表单格式，JSON 请求体不参与参数解析。
• 接码结束后主动完成或取消，及时释放号码。