客户端初始化报错说明

更新时间:

初始化接口错误码

验证码初始化接口指的是带有用户身份标的获取验证码资源的请求,请求域名为xxxxx.captcha-open.aliyuncs.com,其中xxxxx为用户的身份标,关于如何获取身份标,请参考开通验证码服务。初始化请求成功之后的返回应如下图所示:

image.png

如果初始化接口会返回失败,下表为各个失败返回结果的说明和对应的排查建议:

HTTP状态码

错误Code

原因说明及排查建议

400

IllegalUserTag

身份标(prefix)传参不合法。参考开通验证码服务确认该参数是否正确传入。

重要

IllegalUserTag仅适用WebH5客户端接入App客户端接入,不适用微信小程序接入。

400

IllegalScene

场景ID(SceneId)传参不合法。请确认传入的场景ID参数是否正确,确保该场景ID为身份标(prefix)关联的账号下创建。

403

Forbidden.AccountAccessDenied

用户账号欠费。请确认账号状态是否正常。

初始化参数校验报错说明

重要

初始化参数校验报错仅适用WebH5客户端接入App客户端接入,不适用微信小程序接入。

在验证码发起初始化请求之前,SDK会对初始化相关的基础参数进行校验,如果参数不合法,将会在浏览器开发者工具console内弹出相应错误。具体校验内容如下表:

字段

报错内容

示例

通用类型校验

传入参数类型不合法,请参见参数说明传入对应类型的值。

immediate参数传入字符串'false',则会报如下错误:

image.png

language

language参数传入值不合法,请参见验证码2.0支持的语言

language参数传入'abc',则会报如下错误:

image.png

region

region参数传入值不合法,请参见region参数说明检查此参数是否符合要求。

region参数传入'zh',则会报如下错误:

image.png

mode

mode参数传入值不合法,目前支持弹出式(popup)和嵌入式(embed)。请参见mode参数说明检查此参数是否符合要求。

mode参数传入'popout',则会报如下错误:

image.png

element/button

element/button参数传入值不合法,请确保element/button元素在页面中存在,且element/button参数和页面上的element/button元素的ID选择器相匹配。

element/button参数传入'abc',页面没有IDabc的元素,则会报如下错误:

image.png

image.png