# 研学开放平台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

注意事项

appIdappKey需要提前在研学开放平台-系统设置-应用管理 (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
}