智能多媒体服务

  • 智能多媒体 > API 文档 > 人脸核验 >人脸核验增强版

    人脸核验增强版

    最近更新时间:2021-09-08 18:12:31

    产品简介

    人脸核验(增强版)基于活体检测、证件OCR、人脸识别等手段,在对自然人真实身份进行校验的同时,使用智能决策引擎进行综合分析,输出最终认证结果。采用多种手段提升刷脸时的安全性,能覆盖所有主流的黑灰产攻击手法。

    接入流程

    说明

    1 ⽤户到 faceid-sdk 的 portal 上创建 app, 获得 app_id 
    2 ⽤户服务端使⽤ QD 签算⽅式调⽤七⽜服务获取⼈脸核验所需的 token 
    3 ⽤户服务端将 token 下发⾄⽤户 app, ⽤户 app 使⽤ token 初始化 sdk 
    4 sdk 通过 token 调⽤七⽜服务, 调⽤完成后七⽜服务端会根据⽤户设置的回调地址进⾏回调, 同时七⽜ 服务端返回⼀个 request_id 给 sdk ⽤于查询结果

    时序图

    image.png

    SDK下载

    iOS:GXKit-iOS.zip
    Android:GXandroid.zip

    获取app_id

    点此跳转链接
    1 点击新建
    image.png
    2 填写app参数
    注意:id 必填;回调地址选填, 如果没有回调地址则不进⾏回调
    image.png
    3 点击保存

    QD Token签算方式

    // app_id 加上过期时间
    src = "<app_id>:<expiration>"
    encodedSrc = urlsafe_base64_encode(src)
    // 计算HMAC-SHA1签名,并对签名结果做URL安全的Base64编码
    sign = hmac_sha1(encodedSrc, "Your_Secret_Key")
    encodedSign = urlsafe_base64_encode(sign)
    // 拼接上述结果得到 token
    token = "QD " + Your_Access_Key + ":" + encodedSign + ":" + encodedSrc
    

    获取 sdk token

    请求信息

    POST https://ap-open-z0.qiniuapi.com/faceid-sdk/api/face-hdphotoauth/token
    Host: ap-open-z0.qiniuapi.com
    Authorization: <token>
    Content-Type: application/json
    {
    "real_name": "",
    "id_card": ""
    }
    

    返回信息

    200 OK
    Content-Type: application/json
    {
    "face_id": "",
    "token": ""
    }
    

    ⽤户查询结果

    注意:face_id 和 request_id 两个参数⼆选⼀, 两者都传的时候优先使⽤ request_id
    注意:⽬前权威⼈脸结果在服务端保存的时⻓为1⼩时(可调整), 超时后结果将⾃动删除, 主动查询会报 404

    请求信息

    GET https://ap-open-z0.qiniuapi.com/faceid-sdk/api/facehdphotoauth/result?face_id=&request_id=
    Host: ap-open-z0.qiniuapi.com
    Authorization: <token>
    

    返回信息

    200 OK
    Content-Type: application/json
    {
    "face_id": "",
    "request_id": "",
    "response": {
    "session_id": "12345678",
    "similarity": 70,
    "errorcode": 0,
    "errormsg": "OK"
     }
    }
    

    服务端错误返回

    返回信息

    {
     "code": 400,
     "status_code": 400,
     "message": "bad request"
    }
    

    错误码

    code message
    400 客户端请求错误
    404 客户端请对应资源未找到
    500 服务端错误
    599 未知错误

    价格

    1.2元/次

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