【手机号认证】短信验证码校验

更新时间:2025-09-15 15:39:55

接口描述

回填校验运营商三要素短信验证码

接口

/v2/identity/auth/pub/individual/{flowId}/telecom3Factors

请求方式

PUT

请求头

提供两种安全接入方式,对应参数如何获取,参考文档【请点击】。

请求参数

参数名称

类型类型

必选

参数位置

参数说明

flowId

string

path

认证流程ID

authcode

string

body

短信验证码,用户收到的6位数字验证码

响应参数

参数名称

类型

必选

参数说明

code

int32

业务码,0表示成功,非0表示异常。

message

string

返回结果

请求示例  

{
    "authcode": "123456"
}

响应示例

 {
    "code": 0,   
    "message": "成功"
  }

错误码

错误码

错误描述

解决方案

30500002

认证流程已结束

请核实当前认证流程是否已经认证完成

30500003

认证流程已失效,请重新发起认证

认证流程超过30天会自动失效,需重新发起认证流程

30500004

认证流程不存在

请核实传入的flowId是否真实存在

30500101

参数错误:短信验证码不能为空

请核实验证码是否为空

30501005

请先完成运营商三要素信息核验

当前流程并不是通过运营商三要素认证接口返回,请核实或通过运营商三要素认证接口发起认证流程

30503002

验证码校验失败

请核实验证码是否真实有效

30503004

验证码校验失败,已达到最大次数限制

验证次数超过上限,请重新发起运营商三要素认证流程

30503006

短信验证码已过时效性,请重新发送

验证码超过15分钟已失效,请重新发起运营商三要素认证流程

30500116

格式校验不通过,请检查填入信息是否有多余空格

请核实入参是否存在空格


我要纠错