# 研学开放平台JS-SDK-TICKET获取
开发者在生成研学开放平台的签名时,必须先获取js_ticket
。正常情况下,js_ticket的有效期为7200秒,通过access_token
来获取。由于获取js_ticket
的api调用次数非常有限,频繁刷新js_ticket
会导致api调用受限,影响自身业务,开发者必须在自己的服务全局缓存js_ticket
。
# 获取access_token
获取access_token
的方式参见文档:知网研学开放平台文档-认证中心-客户端模式获取jwt (opens new window)
# 根据access_token获取临时ticket
接口地址 :http://gateway--cnki--net--https.cnki.mdjsf.utuvpn.utuedu.com:9000/openx/jssdk/auth/ticket
请求方式: get
接口描述: 根据access_token获取临时ticket
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
appId | 开放平台申请的客户端appid | query | true | String | |
appKey | 开放平台申请的客户端apikey | query | true | String | |
Authorization | 请求的token,获取方式详见:知网研学开放平台文档-认证中心-客户端模式获取JWT (opens new window) | header | true | string |
注意事项
appId
和appKey
需要提前在研学开放平台-系统设置-应用管理 (opens new window)申请,申请方案详见:快速入门 | 知网研学开放平台文档-创建应用 (opens new window)
Authorization
参数是携带在请求的header
中,格式示例(注意Bearer 后有空格):
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCaWF...
创建完应用后,点击编辑,勾选/jssdk/auth/ticket
接口,并点击保存,之后等待审核,审核通过后即可使用。
响应状态
状态码 | 说明 | schema |
---|---|---|
200 | 请求成功 | |
400200 | 无效Token! | |
400500 | 系统异常,请联系管理员! |
响应参数
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | 响应编码 | integer | |
success | 请求是否成功 | boolean | |
content | 响应数据 | object | |
message | 提示消息 | string | |
count | 数据条数 | Integer | |
total | 数据总条数 | Integer |
响应示例
{
"success": true,
"message": "SUCCESS",
"content": {
"ticket": "b1326674b1d260206f5ba0d62981300c31d9526c",
"expires_in": "7172"
},
"count": null,
"total": null,
"code": 200
}