获取 NONCE ticket

最近更新时间:2024-07-29 17:21:41

我的收藏

注意事项

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

请求

请求 URL:https://kyc1.qcloud.com/api/oauth2/api_ticket
请求方法:GET
请求参数:
参数
说明
类型
长度(字节)
是否必填
appId
业务流程唯一标识,即 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://kyc1.qcloud.com/api/oauth2/api_ticket?appId=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 都失效。