接口简介

  • 查询单个用户信息

接口请求说明

请求方式

GET https://{hostname}.qianfanapi.com/openapi/users/{user_id}?expand=groups

请求参数

参数名 类型 是否必须 说明
expand string 值示例:groups,level 以, 分隔当
groups:,用户组列表
level: 等级信息

请求示例

# GET请求
curl -X GET  'https://{hostname}.qianfanapi.com/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": "答应"
    }
  },
  "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 等级名
文档更新时间: 2020-07-28 16:34   作者:千帆云