服务端（Restful API）

如果使用Token登录方式，在集成小程序 SDK 时，需要第三方服务集成小鱼Restful API，以便于向第三方小程序提供Token进行登录，此文档将介绍如何获取用户资源池账号和创建Token操作，请阅读；

1. 创建 500 个用户资源池账号（业务上需要循环使用，同一时间相同账号可能会互踢）；
2. 创建 Token （用于小程序登录时使用，此 Token 有五分钟失效时间）；

SDK 集成流程图

服务端准备工作

1. 获取用户资源池

获取创建的用户资源池，获取 500 个用户资源，三方需要自行管理用户资源状态，以保证每一个会议拥有不同的用户资源信息。 此接口会一次性返回 500 条数据，数据较多，需要三方自行存储管理，建议此接口只调用一次。

Rest API

方法：

GET https://sdk.xylink.com/api/rest/external/v1/miniprogram/users?enterpriseId=xxx&appId=xxx&signature=xxx

类型：GET​

参数：

• enterpriseId：{ string } 企业 ID，向对接人获取或者通过企业管理平台创建
• appId：{ string } 应用 ID，在企业管理平台注册获取
• signature：{ string } 见 ​​签名方法​​

返回值：

[
    {"userName":"+86-110220330"},
    {"userName":"+86-110220331"},
    ...
]

备注

1. 当会议中使用相同的用户资源信息获取的 token 进行入会操作，会造成前一个账号被踢会。
2. 请服务端自行维护用户资源池的状态
3. 签名建议通过服务器生成

2. 根据用户资源信息，生成 Token

通过上一步分配的用户资源池信息，生成 Token。 此 Token 失效时间是五分钟，建议每次登录前，调用接口获取 Token 值。

Rest API

方法：

PUT https://sdk.xylink.com/api/rest/external/v1/miniprogram/token?enterpriseId=xxx&signature=xxx

类型：PUT

参数：

• enterpriseId：{ string } 企业 ID 向对接人获取或者通过企业管理平台创建
• signature：{ string } 见 ​​服务端 API-签名方法​​

Body：

{
  // 通过企业管理平台创建appId值
  "appId": "",
  // 参见服务端-获取用户资源池接口获取userName
  "userName": "xxx"
}

返回值：

{
  // 忽略
  "appId": "xxx",
  // 忽略
  "userName": "xxx",
  // 小程序登录接口需要使用此接口
  "token": "xxx",
  // 失效时间，默认5分钟token会自动失效
  "expireTime": 1541418413000
}

备注

上述两个接口，建议在三方后端完成，提供给三方小程序接口，用于获取 Token 即可。