Skip to content

服务端

错误信息数据结构

typescript
{
    "code": string,
    "data"?: object,
    "message"?: string,
    "success": false
}

当 HTTP 状态为 200successtrue 表示成功,其他情况表示失败

HTTP 错误

状态码含义如何处理
401/403无权访问检查 API KEY 是否正确
400服务端错误根据 code 具体区分错误类型 ,见下方

HTTP 400 错误

code含义如何处理
20001超过请求速率限制为避免影响业务,建议此时通过验证

JS SDK

未在域名白名单中的域名访问会提示跨域或者 401/403 错误,请先申请域名白名单

兜底降级方案

提醒:我们会极力保证服务的稳定性,发生故障的概率极低,但是依然需要做好兜底方案!

当行为验证码服务故障时,需要有兜底方案保证业务的可用性。

当验证码服务发生故障时 JS SDK 无法访问后端服务时,在用户完成验证后会发送一个前端生成的 ID(正常情况该 ID 由后端生成)并且以 NOSERVER_ 开头,此时如果业务后端调用行为验证码服务的后端也发生了超时或者错误则可以认为证码服务发生故障了,此时应该通过验证避免对正常业务造成影响。