智能多媒体服务

  • 智能多媒体服务 > 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元/次

    以上内容是否对您有帮助?
  • Qvm free helper
    Close