获取用户详情接口

    获取指定用户的基本信息和账户详情,包括用户名、联系方式、账户状态、余额等用户相关数据。

    注意事项

    • 该接口采用GET方法
    • 需要提供目标用户的ID来查询用户详情
    • 根据用户权限,可能只能查看自己的信息或有权限查看的用户信息
    • 返回用户的基本信息和账户相关信息

    请求地址

    {域名地址}/api/user/detail
    

    说明:{域名地址} 需要替换成你的域名地址,如 https://www.anqicms.com/api/user/detail

    请求语法

    GET {域名地址}/api/user/detail
    

    请求头

    此接口还涉及公共请求头。更多信息,请参见公共请求头(Common Request Headers)。

    请求参数

    字段名 类型 必填 说明
    userId int 是 用户ID,指定要查询的用户

    响应头

    此接口仅涉及公共响应头。更多信息,请参见公共请求头(Common Request Headers)。

    返回参数

    字段名 类型 说明
    code int 错误码
    msg string 错误原因说明
    data object 用户详情数据

    data 参数

    字段名 类型 说明
    id int 用户ID
    parent_id int 上级用户ID
    user_name string 用户名
    real_name string 真实姓名
    introduce string 个人介绍
    avatar_url string 用户头像相对地址
    full_avatar_url string 用户头像完整地址
    email string 邮箱地址
    phone string 手机号码
    group_id int 用户组ID
    is_retailer int 是否是分销员,0-否,1-是
    balance int 用户余额
    total_reward int 分销员累计收益
    invite_code string 用户邀请码
    last_login int 最近一次登录时间戳
    expire_time int 账户过期时间戳
    created_time int 注册时间戳
    updated_time int 更新时间戳
    status int 用户显示状态
    extra object 用户扩展信息
    group object 用户组信息
    link string 用户个人页面链接

    使用示例

    请求示例

    GET /api/user/detail?userId=1000 HTTP/1.1
    Host: www.anqicms.com
    

    响应示例

    {
      "code": 0,
      "msg": "",
      "data": {
        "id": 1000,
        "parent_id": 0,
        "user_name": "admin",
        "real_name": "",
        "introduce": "这是介绍",
        "avatar_url": "uploads/202211/21/14f56760596b5328.webp",
        "full_avatar_url": "https://www.anqicms.com/uploads/202211/21/14f56760596b5328.webp",
        "email": "",
        "phone": "",
        "group_id": 2,
        "status": 1,
        "is_retailer": 0,
        "balance": 0,
        "total_reward": 0,
        "invite_code": "anqicms",
        "last_login": 1702912236,
        "expire_time": 1997404800,
        "created_time": 1669012062,
        "updated_time": 1679536756,
        "extra": null,
        "group": null,
        "link": ""
      }
    }
    

    错误代码

    错误码 说明
    0 OK
    -1 错误,错误原因在 msg 中指出
    1001 未登录
    1002 未授权
    200 API 请求 OK