手机号二要素接口
2024.11.20 10:20:47
通过对比权威数据源,对用户上传的姓名、手机号进行验证,校验此二要素是否一致
接口说明
- 只支持移动、电信、联通、广电号下发的手机卡
鉴权说明
易盾信息认证服务使用签名方法对接口进行鉴权,所有接口每一次请求都需要包含签名信息(signature参数),以验证用户身份,防止信息被恶意篡改。目前支持MD5,SHA1,SHA256,SM3几种加密算法,详细信息,请参见接口鉴权
请求
请求地址
名称 | 值 |
---|---|
HTTP URL | https://verify.dun.163.com/v1/mobile2Ele/check |
HTTP Method | POST |
请求头
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
Content-Type | String | 是 | 固定值:"application/x-www-form-urlencoded" |
请求参数
请求参数由请求公共参数和请求业务参数两部分组成,通用参数见请求通用字段
名称 | 类 型 | 必填 | 最大长度 | 描述 |
---|---|---|---|---|
name | String | 是 | 32 | 用户真实姓名,以身份证上姓名为准 |
phone | String | 是 | 32 | 手机号,建议开发者增加手机号真实性校验来防刷 |
请求体示例
name=张三&phone=13358123456&version=v1&businessId=xxx×tamp=1638180222235&nonce=xxx&secretId=xxx&signature=xxx
响应
响应结果
响应字段如下,响应通用字段已省略,详细见响应公共字段
名称 | 类型 | 必须返回 | 描述 |
---|---|---|---|
status | Number | 是 | 认证结果,1-通过 2-不通过 3-查无结果 0-待定 |
reasonType | Number | 否 | 原因详情 2-输入姓名和手机号不一致 3-查无此手机号 4-认证信息格式错误 7-结果获取失败,请重试 12-涉及高敏感人员 |
taskId | String | 是 | 本次请求数据标识,可以根据该标识在控制台进行数据查询 |
isPayed | Number | 是 | 本次请求是否收费标识,1代表收费,0代表不收费 |
mobileType | String | 是 | 运营商类型:1-移动,2-联通,3- 电信,9,-未知 |
响应体示例
{
"code": 200,
"msg": "ok",
"result": {
"status": 1,
"taskId": "xxxxxxxxxxxxxx",
"reasonType": 1,
"isPayed": 1
}
}
响应返回码
响应返回码见:响应返回码