获取 JWT Token

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

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

提示

• 该接口暂仅适用于使用新加坡数据中心的应用。详见海外数据中心。
• 调用该接口必须使用专用的 API 域名： https://ai.sg-light-edge.com

适用场景

即时通讯业务客户端 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 流程图

请求方法

POST： https://ai.sg-light-edge.com/jwt/getToken.json

频率限制： 每秒钟限 100 次

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

正文参数

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

参数	类型	必传	说明
userId	String	是	用户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 对象：

返回值	返回类型	说明
code	Number	返回码，200 为正常。
token	String	token 值

返回结果示例

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

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