客户端初始化报错说明
初始化接口错误码
验证码初始化接口指的是带有用户身份标的获取验证码资源的请求,请求域名为xxxxx.captcha-open.aliyuncs.com
,其中xxxxx为用户的身份标,关于如何获取身份标,请参考开通验证码服务。初始化请求成功之后的返回应如下图所示:
如果初始化接口会返回失败,下表为各个失败返回结果的说明和对应的排查建议:
HTTP状态码 | 错误Code | 原因说明及排查建议 |
400 | IllegalUserTag | 身份标(prefix)传参不合法。参考开通验证码服务确认该参数是否正确传入。 重要 IllegalUserTag仅适用Web和H5客户端接入、App客户端接入,不适用微信小程序接入。 |
400 | IllegalScene | 场景ID(SceneId)传参不合法。请确认传入的场景ID参数是否正确,确保该场景ID为身份标(prefix)关联的账号下创建。 |
403 | Forbidden.AccountAccessDenied | 用户账号欠费。请确认账号状态是否正常。 |
初始化参数校验报错说明
初始化参数校验报错仅适用Web和H5客户端接入、App客户端接入,不适用微信小程序接入。
在验证码发起初始化请求之前,SDK会对初始化相关的基础参数进行校验,如果参数不合法,将会在浏览器开发者工具console内弹出相应错误。具体校验内容如下表:
字段 | 报错内容 | 示例 |
通用类型校验 | 传入参数类型不合法,请参见参数说明传入对应类型的值。 | 如immediate参数传入字符串'false',则会报如下错误: |
language | language参数传入值不合法,请参见验证码2.0支持的语言 | 如language参数传入'abc',则会报如下错误: |
region | region参数传入值不合法,请参见region参数说明检查此参数是否符合要求。 | 如region参数传入'zh',则会报如下错误: |
mode | mode参数传入值不合法,目前支持弹出式(popup)和嵌入式(embed)。请参见mode参数说明检查此参数是否符合要求。 | 如mode参数传入'popout',则会报如下错误: |
element/button | element/button参数传入值不合法,请确保element/button元素在页面中存在,且element/button参数和页面上的element/button元素的ID选择器相匹配。 | 如element/button参数传入'abc',页面没有ID为abc的元素,则会报如下错误: |