响应返回码
2023.09.13 09:51:58
响应返回码(code)反映了易盾业务安全服务 API 调用和执行的概要结果。当返回码不为 200 时, 表示请求未正常执行,返回码描述 (msg) 对该结果进行了细化补充,用户可根据返回码判断 API 的执行情况。 所有接口调用返回值均包含 code 和 msg 字段, code 为返回码值,msg 为返回码描述信息,返回码表如下:
HTTP状态码 | 错误码 | 描述 |
---|---|---|
200 | 0 | 无异常 |
200 | 415 | 签名校验错误 |
200 | 419 | 参数校验错误,例如参数类型错误、参数值错误、必填项为空等 |
200 | 430 | qps超限 |
200 | 421 | 验证码版本不匹配 |
常见问题
- 确保secretId, secretKey, businessId参数填写正确,注意businessId不是产品编号
- http请求的参数必须采用form表单格式,如果是自己拼接注意格式正确,不接受json格式的参数
- 计算签名的字符串不需要进行urlencode,但是http传输时需要将参数采用utf-8编辑进行urlencode传输
- 额外传了文档中未提及的字段
测试时,建议直接使用官网demo测试接口调用是否成功,如需修改,请参考官网demo
- 排查公共参数是否配置完全正确:
- 排查传参模式是否为:post模式,并且编码方式Content-Type: application/x-www-form-urlencoded;charset=utf-8
可能出现的情况:
validate值是随便填写的,绕过了前端,直接调用我们二次检验接口
validate重复调用或者过期,validate只能校验一次且20分钟(默认)内有效
后端把公共参数定义成json格式,即使是用form格式提交也会报错
前/后端验证码ID(captchaId)使用的不一致
验证码ID(captchaId)失效,比如试用过期
user字段必传的,可以传空
某个参数名写错,比如字段nonce写成了none、secretId写成sercetId等