接口简介
- 查询单个用户信息
接口请求说明
请求方式
GET https://站点接口域名/openapi/users/{user_id}?expand=groups
请求参数
| 参数名 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| expand | string | 否 | 值示例:groups,level,status 以, 分隔当 groups:,用户组列表 level: 等级信息 status: 用户状态 |
请求示例
# GET请求
curl -X GET 'https://站点接口域名/openapi/users/1' \
-H 'Authorization: Bearer 5d39164d1f281' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json'接口响应说明
响应示例
{
"code": 0,
"text": "",
"data": {
"id": 4,
"username": "qianfan2",
"signature": "1111112333",
"gender": 2,
"birthday": 788889600,
"avatar": "https://qiance.qianfanyun.com/_20180613135301_5b20b13defd43.jpg?interlace/1",
"phone": "",
"groups": [
{
"id": 2051,
"name": "测试图标"
},
{
"id": 2054,
"name": "猴子"
}
],
"level": {
"num": 3,
"name": "答应",
"exp": 1200
},
"status": 1,
},
"time": 1595837437
}响应结果说明
| 字段名 | 类型 | 说明 |
|---|---|---|
| id | int | 用户uid |
| username | string | 用户名 |
| signature | string | 个性签名 |
| gender | int | 性别:0保密 1男 2女 |
| birthday | int | 生日 |
| avatar | string | 头像 |
| phone | string | 手机号 |
| groups | array | 用户组列表,当expand存在groups值时,会获得此参数 |
| –id | int | 用户组id |
| –name | string | 用户组名 |
| level | object | 等级信息 |
| –num | int | 等级 |
| –name | string | 等级名 |
| –exp | int | 经验值 |
| status | int | 状态 0信息不存在等异常 1正常 9冻结 11已注销 |
文档更新时间: 2025-08-07 09:39 作者:千帆云