跳到主要内容

获取 JWT Token

本文描述如何从即时通讯服务端获取翻译插件鉴权专用的 JWT Token。

翻译插件鉴权专用的 JWT Token 不同于 IM 用户连接 IM 服务的 Token,请注意区分。

提示

适用场景

即时通讯业务客户端 SDK 提供了翻译插件,可为 IMLib 与 IMKit SDK 快速接入外部翻译服务。客户端从 App 后端获取有效的 JWT Token,才能向即时通讯服务端请求翻译结果。

即时通讯服务端提供了获取 JWT Token 的 API 接口。该接口必须由 App 后端必须调用。成功获取 Token 后由 App 后端返回给客户端。

JWT

JWT 全称 JSON web Token,是为了在网络应用环境间传递声明而执行的一种基于 JSON 的开放标准。 JWT 包含 header、payload、signature 三部分。通过解析 payload 部分可获取到 Token 有效期和 UserId 等信息。

获取和刷新 JWT Token 流程图

请求方法

POSThttps://ai.sg-light-edge.com/jwt/getToken.json

频率限制: 每秒钟限 100 次

签名规则: 所有服务端 API 请求均需要进行规则校验,详见 API 请求签名

正文参数

HTTP 请求正文数据格式为 application/x-www-form-urlencoded,支持以下 HTTP 表单参数:

参数类型必传说明
userIdString用户Id

请求示例

POST /jwt/getToken.json HTTP/1.1
Host: ai-sg.ronghub.com
App-Key: your-own-app-key
Nonce: 14314
Timestamp: 1408710653000
Signature: 30be0bbca9c9b2e27578701e9fda2358a814c88f
Content-Type: application/x-www-form-urlencoded
Content-Length: 78

userId=jlk456j5

返回结果

HTTP 响应正文包含具有以下结构的 JSON 对象:

返回值返回类型说明
codeNumber返回码,200 为正常。
tokenStringtoken 值

返回结果示例

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{"code":200,"token":""}