文档
测试

手机号三要素核验

POST
http://openapi.sinocloudlab.com/rest/faceid/phoneverification

接口描述

本接口用于校验手机号、姓名和身份证号的真实性和一致性。默认接口请求频率限制:20次/秒。

Header

参数名
类型
描述
必填
Authorization
string
通过API Key和Secret Key获取的access_token,参考“Access Token获取”
必填
Content-Type
string
application/json
必填

请求参数

参数名
类型
描述
必填
id_card
string
身份证号码
必填
name
string
姓名(注:需要是UTF-8编码的中文)
必填
phone
string
手机号
必填
comcode
string
保险公司内部机构、部门代码,为后续提供数据分析服务所用
可选

响应参数

参数名
类型
描述
必填
result
string
业务错误码,认证结果码: 收费结果码 0: 认证通过 -1: 手机号已实名,但是身份证和姓名均与实名信息不一致 -2: 手机号已实名,手机号和证件号一致,姓名不一致 -3: 手机号已实名,手机号和姓名一致,身份证不一致 -4: 信息不一致 -5: 手机号未实名 不收费结果码 -6: 手机号码不合法 -7: 身份证号码有误 -8: 姓名校验不通过 -9: 没有记录 -10: 认证未通过 -11: 验证中心服务繁忙
必填
description
string
业务结果描述。
必填

说明 / 示例

###### token的使用方法 >d 在之后的接口请求中,都应该在头部带上Authorization参数,参数值以Bearer加空格开头,后接{{token}} 例如:Bearer 8d1630b2-7920-4ccd-bf37-e3309f9fdd4f 签名算法,请查看文档:[签名算法](doc:MHaXIJs8) ### 响应说明 中科软开放平台所有API采用通用响应体包含业务响应信息构建而成。 - **通用响应体内通用参数说明:** -- **requestid**:唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 requestid -- **code**:平台响应码,0-成功,其他见响应码表 -- **message**:响应描述,大写SUCCESS表示成功,错误信息描述展示于此 -- **data**:业务响应内容体,以json格式为主,如faceid返回结构含result、description字段 -- **timestamp**:时间戳 -- **extra**:扩展信息 ###### 返回示例: ``` { "requestid": "f904f4cf-75db-4f8f-a5ec-dc4f942c7f7a", "code": 0, "message": "SUCCESS", "data": { "result": "0", //认证结果 "description": "认证通过" //0: 认证通过 -1: 手机号已实名,但是身份证和姓名均与实名信息不一致 -2: 手机号已实名,手机号和证件号一致,姓名不一致 -3: 手机号已实名,手机号和姓名一致,身份证不一致 -4: 信息不一致 -5: 手机号未实名 不收费结果码 -6: 手机号码不合法 -7: 身份证号码有误 -8: 姓名校验不通过 -9: 没有记录 -10: 认证未通过 -11: 验证中心服务繁忙 }, "timestamp": 1509617387, "extra": {} } ```