human: 如何处理七牛云的即时通讯token接口

gpt: [即时通讯](https://developer.qiniu.com/IM) > API 文档 >
[服务端API](https://developer.qiniu.com/IM/api/8094/im-server-api-reference) >
token接口

#  token接口

最近更新时间: 2021-06-29 09:47:45

# token 接口

## 通过用户ID和密码取普通用户token

### 基本信息

**Path：** /token/id

**Method：** POST

**接口描述：**

### 请求参数

**Headers**

参数名称 | 参数值 | 是否必须 | 示例 | 备注  
---|---|---|---|---  
Content-Type | application/json | 是 |  |   
access-token |  | 否 |  | 令牌  
app_id |  | 是 |  | 应用ID  
group_id |  | 否 |  | 仅当access-token为管理员token时，可以设置此字段，表示以此群ID的管理员身份来调用此接口  
user_id |  | 否 |  | 仅当access-token为管理员token时，可以设置此字段，表示以此用户ID的身份来调用此接口  
  
**Body**

名称| 类型| 是否必须| 默认值| 备注| 其他信息  
---|---|---|---|---|---  
device_guid| string| 非必须| | 设备ID, 如果设置，则返回PushToken|   
password| string| 必须| | |   
user_id| integer| 必须| | 用户ID，仅用于用户ID登录| format: int64  
  
### 返回数据

名称| 类型| 是否必须| 默认值| 备注| 其他信息  
---|---|---|---|---|---  
code| integer| 非必须| | 返回码，200是成功| format: int32  
data| object| 非必须| | Token 信息|   
├─ access_key_secret| string| 非必须| | 文件密钥|   
├─ encrypt_type| integer| 非必须| | 是否启用加密连接| format: int32  
├─ expire| integer| 非必须| | 过期时间戳| format: int64  
├─ public_key| string| 非必须| | 公钥|   
├─ push_token| string| 非必须| | 推送Token|   
├─ store_token| string| 非必须| | 文件token|   
├─ token| string| 非必须| | 访问token|   
├─ user_id| integer| 非必须| | 用户ID| format: int64  
message| string| 非必须| | 错误信息，如果成功，该项为null|   
  
## 通过用户名/手机号/邮箱取普通用户token

### 基本信息

**Path：** /token/login

**Method：** POST

**接口描述：**

### 请求参数

**Headers**

参数名称 | 参数值 | 是否必须 | 示例 | 备注  
---|---|---|---|---  
Content-Type | application/json | 是 |  |   
access-token |  | 否 |  | 令牌  
app_id |  | 是 |  | 应用ID  
group_id |  | 否 |  | 仅当access-token为管理员token时，可以设置此字段，表示以此群ID的管理员身份来调用此接口  
user_id |  | 否 |  | 仅当access-token为管理员token时，可以设置此字段，表示以此用户ID的身份来调用此接口  
  
**Body**

名称| 类型| 是否必须| 默认值| 备注| 其他信息  
---|---|---|---|---|---  
device_guid| string| 非必须| | 设备ID, 如果设置，则返回PushToken|   
login_name| string| 必须| | 登录名，可以是手机号，邮箱，用户名|   
password| string| 必须| | |   
  
### 返回数据

名称| 类型| 是否必须| 默认值| 备注| 其他信息  
---|---|---|---|---|---  
code| integer| 非必须| | 返回码，200是成功| format: int32  
data| object| 非必须| | Token 信息|   
├─ access_key_secret| string| 非必须| | 文件密钥|   
├─ encrypt_type| integer| 非必须| | 是否启用加密连接| format: int32  
├─ expire| integer| 非必须| | 过期时间戳| format: int64  
├─ public_key| string| 非必须| | 公钥|   
├─ push_token| string| 非必须| | 推送Token|   
├─ store_token| string| 非必须| | 文件token|   
├─ token| string| 非必须| | 访问token|   
├─ user_id| integer| 非必须| | 用户ID| format: int64  
message| string| 非必须| | 错误信息，如果成功，该项为null|   
  
## 通过用户名和密码取普通用户token

### 基本信息

**Path：** /token/user

**Method：** POST

**接口描述：**

### 请求参数

**Headers**

参数名称 | 参数值 | 是否必须 | 示例 | 备注  
---|---|---|---|---  
Content-Type | application/json | 是 |  |   
access-token |  | 否 |  | 令牌  
app_id |  | 是 |  | 应用ID  
group_id |  | 否 |  | 仅当access-token为管理员token时，可以设置此字段，表示以此群ID的管理员身份来调用此接口  
user_id |  | 否 |  | 仅当access-token为管理员token时，可以设置此字段，表示以此用户ID的身份来调用此接口  
  
**Body**

名称| 类型| 是否必须| 默认值| 备注| 其他信息  
---|---|---|---|---|---  
device_guid| string| 非必须| | 设备ID, 如果设置，则返回PushToken|   
name| string| 必须| | 用户名，仅用于用户名登录|   
password| string| 必须| | |   
  
### 返回数据

名称| 类型| 是否必须| 默认值| 备注| 其他信息  
---|---|---|---|---|---  
code| integer| 非必须| | 返回码，200是成功| format: int32  
data| object| 非必须| | Token 信息|   
├─ access_key_secret| string| 非必须| | 文件密钥|   
├─ encrypt_type| integer| 非必须| | 是否启用加密连接| format: int32  
├─ expire| integer| 非必须| | 过期时间戳| format: int64  
├─ public_key| string| 非必须| | 公钥|   
├─ push_token| string| 非必须| | 推送Token|   
├─ store_token| string| 非必须| | 文件token|   
├─ token| string| 非必须| | 访问token|   
├─ user_id| integer| 非必须| | 用户ID| format: int64  
message| string| 非必须| | 错误信息，如果成功，该项为null|   
  
以上内容是否对您有帮助？