获取分销员详情接口

获取指定分销员的详细信息，包括用户基本信息、分销状态和用户组信息。

注意事项

该接口采用GET方法
需要提供分销员ID参数
需要用户登录验证
返回分销员的完整用户信息和分组详情
包含分销员的累计收益、邀请码等信息

请求地址

{域名地址}/api/retailer/info

说明：{域名地址} 需要替换成你的域名地址，如 https://www.anqicms.com/api/retailer/info

请求语法

GET {域名地址}/api/retailer/info

请求头

此接口还涉及公共请求头。更多信息，请参见公共请求头（Common Request Headers）。

请求参数

字段名	类型	必填	说明
retailer_id	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	真实姓名
avatar_url	string	用户头像地址
email	string	邮箱地址
phone	string	手机号
group_id	int	用户组ID
is_retailer	int	是否是分销员（1是，0否）
balance	int	用户余额（单位：分）
total_reward	int	分销员累计收益（单位：分）
invite_code	string	用户邀请码
last_login	int	最近一次登录时间戳
expire_time	int	过期时间戳
created_time	int	注册时间戳
updated_time	int	更新时间戳
status	int	用户显示状态
group	object	用户分组信息

group 用户分组信息参数

字段名	类型	说明
id	int	分组ID
title	string	分组名称
description	string	分组简介
level	int	分组等级
price	int	分组价格（单位：分）
setting	object	分组配置信息
status	int	分组显示状态
favorable_price	int	优惠价格

setting 分组配置信息参数

字段名	类型	说明
share_reward	int	分享奖励百分比
parent_reward	int	上级奖励百分比
discount	int	折扣百分比
expire_day	int	有效期天数（0为不限制）

使用示例

请求示例

GET /api/retailer/info?retailer_id=1000 HTTP/1.1
Host: www.anqicms.com

响应示例

{
  "code": 0,
  "msg": "",
  "data": {
    "id": 1000,
    "created_time": 1669012062,
    "updated_time": 1679536756,
    "parent_id": 0,
    "user_name": "retailer1",
    "real_name": "分销员1",
    "avatar_url": "uploads/202211/21/14f56760596b5328.webp",
    "email": "retailer1@example.com",
    "phone": "13800138000",
    "group_id": 2,
    "status": 1,
    "is_retailer": 1,
    "balance": 150000,
    "total_reward": 500000,
    "invite_code": "retailer123",
    "last_login": 1702912236,
    "expire_time": 1997404800,
    "group": {
      "id": 2,
      "created_time": 0,
      "updated_time": 1696919880,
      "title": "高级分销员",
      "description": "高级分销员特权...",
      "level": 2,
      "status": 1,
      "price": 9900,
      "setting": {
        "share_reward": 25,
        "parent_reward": 5,
        "discount": 90,
        "expire_day": 0
      },
      "favorable_price": 8900
    },
    "full_avatar_url": "https://www.anqicms.com/uploads/202211/21/14f56760596b5328.webp",
    "link": ""
  }
}

错误代码

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