错误码

接口调用失败时会返回对应错误码和错误信息。发送失败不会扣除配额，但会记录发送日志。

错误码列表

错误码	HTTP 状态码	说明
InvalidParameter	400	参数错误，如缺少必填参数、手机号格式不正确、JSON 格式无效等。
InvalidSysKey	401	SysKey 无效或已被禁用。
InvalidAccessKeyId.NotFound	401	AccessKeyId 无效或已被禁用。
SignatureDoesNotMatch	401	签名验证失败。
IpNotAllowed	403	当前 IP 不在白名单中，访问被拒绝。
InvalidPhoneNumber	400	号码真实性检测失败，该号码不是有效的手机号。
VirtualNumberBlocked	400	虚拟运营商号段已被拦截，不允许发送短信。
CarrierBlocked	400	第三方运营商号码已被拦截，仅支持电信/联通/移动/广电号码。
InvalidTemplate	400	模板不存在或未通过审核。
OverQuota	429	短信包余额不足，请购买短信包。
RateLimitExceeded	429	超过速率限制。
MethodNotAllowed	405	请求方法不允许，仅支持 GET 和 POST。
InternalError	400/500	短信配置错误或数据库错误。
NETWORK_ERROR	400	网络请求失败。
PARSE_ERROR	400	响应格式错误。

排查建议

• InvalidParameter：检查必填参数、手机号格式、验证码长度和 JSON 格式。
• InvalidTemplate：确认模板已在用户端申请，并已通过管理员审核。
• SignatureDoesNotMatch：确认参与签名的参数、请求方法（GET/POST 签名结果不同）和 access_key_secret 是否一致。
• IpNotAllowed：在短信后台检查 IP 白名单配置，确认出口 IP 已加入白名单。
• InvalidPhoneNumber、VirtualNumberBlocked 或 CarrierBlocked：检查号码是否为真实手机号及运营商类型，或联系管理员调整检测策略。
• OverQuota：在短信后台购买短信包后再试。
• RateLimitExceeded：降低调用频率，或在后台调整速率限制配置。