智能多媒体服务 > API 文档 > 人脸核验 >功能接口 >手机号三要素核验旗舰版

手机号三要素核验旗舰版

最近更新时间: 2022-03-25 11:03:02

接口简介

手机号三要素旗舰版采用权威官方数据库进行比对，验证姓名，证件号码，手机号码的真实性和一致性。

请求参数

请求URL: https://ap-gate-z0.qiniuapi.com/faceref/threemeta/check/plus

请求方式: POST

请求 Header:

字段	取值
Content-Type	application/json
Authorization	Qiniu <AccessKey>:<Sign> 注意: 用户请根据 AccessKey 和 SuccessKey 生成鉴权，以便进行身份验证。<Sign> 的取值请参考七牛鉴权

请求 Body:

字段	类型	是否必选	说明
cert_name	string	Y	真实姓名
cert_no	string	Y	证件号码
mobile	string	Y	手机号码

返回结果

字段	类型	说明
result_code	string	结果码，一般OK表示调用成功
result_msg	string	异常信息的文本描述
match	string	true: 匹配通过; false: 匹配失败
extern_info	string	json 字符串, 返回不一致的具体原因

extern_info 中具体信息

字段	类型	说明
checkResultDetail	string	该字段表示核验结果详情，取值范围如下： 1：三要素一致 2：手机号已实名，但是身份证和姓名均与实名信息不一致 3：手机号已实名，手机号和证件号一致，姓名不一致 4：手机号已实名，手机号和姓名一致，身份证不一致 5：其他不一致

示例

请求示例

POST /faceref/threemeta/check/plus HTTP/1.1
Host: ap-gate-z0.qiniuapi.com
Content-Type: application/json
Authorization: Qiniu xxxxxxx

{
    "cert_name": "张三",
    "cert_no": "33010219001123123X",
    "mobile": "13812341234"
}

返回示例

HTTP/1.1 200 OK
Content-Type: application/json

{
    "result_code":"THREEMETA_MATCH_FAIL",
    "result_msg":"匹配失败(Z8803)",
    "match":"false",
    "extern_info":"{\"checkResultDetail\":\"2\"}"
}

错误码

错误码	说明
OK	匹配成功(Z8802)
THREEMETA_MATCH_FAIL	匹配失败(Z8803)
INITIALIZE_INVALID_CERT_NO	用户身份证号码信息无效，请填写正确的身份号码信息(Z8111)
INITIALIZE_INVALID_CERT_NAME	姓名无效，请填写正确的姓名(Z8109)
INITIALIZE_INVALID_MOBILE_NO	手机号码无效，请填写正确的手机号码(Z8113)
THREEMETA_THIRDPARTY_ERROR	数据源调用异常，请您稍后再试(Z8801)
THREEMETA_NOT_EXIST_ERROR	查无此号码（Z8931）
THREEMETA_NOT_SUPPORT_ERROR	非运营商号码（Z8932）
THREEMETA_HIGH_RISK_ERROR	请求次数过多，当日请求次数超上限（Z8933）
SYSTEM_ERROR	抱歉，系统出错了，请您稍后再试(Z8198)

价格

0.8元/次

以上内容是否对您有帮助？