Appearance
服务端
错误信息数据结构
typescript
{
"code": string,
"data"?: object,
"message"?: string,
"success": false
}
当 HTTP 状态为 200
且 success
为 true
表示成功,其他情况表示失败
HTTP 错误
状态码 | 含义 | 如何处理 |
---|---|---|
401/403 | 无权访问 | 检查 API KEY 是否正确 |
400 | 服务端错误 | 根据 code 具体区分错误类型 ,见下方 |
HTTP 400 错误
code | 含义 | 如何处理 |
---|---|---|
20001 | 超过请求速率限制 | 为避免影响业务,建议此时通过验证 |
JS SDK
未在域名白名单中的域名访问会提示跨域或者 401/403 错误,请先申请域名白名单
兜底降级方案
提醒:我们会极力保证服务的稳定性,发生故障的概率极低,但是依然需要做好兜底方案!
当行为验证码服务故障时,需要有兜底方案保证业务的可用性。
当验证码服务发生故障时 JS SDK 无法访问后端服务时,在用户完成验证后会发送一个前端生成的 ID(正常情况该 ID 由后端生成)并且以 NOSERVER_
开头,此时如果业务后端调用行为验证码服务的后端也发生了超时或者错误则可以认为证码服务发生故障了,此时应该通过验证避免对正常业务造成影响。