获取 NONCE ticket

最近更新时间:2019-08-21 17:16:39

注意事项

  • 前置条件:请合作方确保 Access Token 已经正常获取,获取方式请参见 Access Token 获取
  • NONCE ticket 是合作方前端包含 App 和 H5 等生成签名鉴权参数之一,启动 H5 或 SDK 人脸核身。
  • API ticket 的 NONCE 类型,其有效期为120秒,且一次性有效,即每次启动 SDK 刷脸都要重新请求 NONCE ticket。

请求

  • 请求 URL:https://idasc.webank.com/api/oauth2/api_ticket
  • 请求方法:GET
  • 请求参数:
    参数说明类型长度(字节)是否必填
    app_id请添加小助手微信 faceid001,进行线下对接获取String腾讯云线下对接决定
    access_token请根据 Access Token 获取 指引进行获取String腾讯云线下对接决定
    typeticket 类型,默认值:NONCE(必须大写)String20
    version版本号String20
    user_id当前使用用户的唯一标识
    注意:合作伙伴必须保证 user_id 的全局唯一性
    String30
  • 请求示例:
    https://idasc.webank.com/api/oauth2/api_ticket?app_id=xxx&access_token=xxx&type=NONCE&version=1.0.0&user_id=xxx

响应

响应示例:

{
    "code": "0",
    "msg": "请求成功",
    "transactionTime": "20151022044027",
    "tickets": [{
        "value": "ticket_string",
        "expire_in": "120",
        "expire_time": "20151022044027"
    }]
}
注意:

  • code 不为0则表示获取失败,可以根据 code 和 msg 字段进行定位和调试。code 详情请参见 错误码
  • expire_in 为 access_token 的最大生存时间,单位:秒,合作伙伴在判定有效期时以此为准
  • expire_time 为 access_token 失效的绝对时间,由于各服务器时间差异,不能以此作为有效期的判定依据,只作为展示使用。
  • access_token 失效时,该 access_token 生成的 ticket 都失效。