人脸核身
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 人脸核身 > 含 UI 集成方案 > 基础版人脸核身 > App SDK > 登录鉴权 > 获取 NONCE ticket

获取 NONCE ticket

最近更新时间：2023-10-12 11:22:14

我的收藏

本页目录：

注意事项

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

请求

请求 URL：https://kyc.qcloud.com/api/oauth2/api_ticket
请求方法：GET
请求参数：
参数
说明
类型
长度（字节）
是否必填
app_id
业务流程唯一标识，即 WBappid，可参考 获取 WBappid 指引在人脸核身控制台内申请
String
8
是
access_token
请根据 Access Token 获取 指引进行获取
String
90
是
type
ticket 类型，默认值：NONCE（必须大写）
String
20
是
version
版本号
String
20
是
user_id
当前使用用户的唯一标识，需合作伙伴自行定义注意：合作伙伴必须保证 user_id 的全局唯一性，不要带有特殊字符
String
32
是
请求示例：
https://kyc.qcloud.com/api/oauth2/api_ticket?app_id=xxx&access_token=xxx&type=NONCE&version=1.0.0&user_id=xxx

响应

响应参数：
参数
类型
说明
code
String
0：成功
非0：失败
详情请参见 SaaS 服务错误码
msg
String
请求结果描述
transactionTime
String
调用接口的时间
tickets
list
ticket 返回数组
value
String
ticket 的值
expire_time
String
ticket 失效的绝对时间
expire_in
int
ticket 的最大生存时间
响应示例：
{
      "code": "0",
      "msg": "请求成功",
      "transactionTime": "20151022044027",
      "tickets": [
        {
              "value": "ticket_string",
              "expire_in": "120",
              "expire_time": "20151022044027"
        }
    ]
}
注意
code 不为0则表示获取失败，可以根据 code 和 msg 字段进行定位和调试。code 详情请参见 SaaS 服务错误码。
expire_in 为 access_token 的最大生存时间，单位：秒，合作伙伴在判定有效期时以此为准。
expire_time 为 access_token 失效的绝对时间，由于各服务器时间差异，不能以此作为有效期的判定依据，只作为展示使用。
access_token 失效时，该 access_token 生成的 ticket 都失效。
中国站