获取分销订单列表接口

获取分销员相关的订单列表，支持分页查询。

注意事项

该接口采用GET方法
需要用户登录验证（当前用户必须是分销员）
返回当前分销员推广产生的订单列表
支持分页查询，可指定当前页码和每页数量
包含订单的详细信息、买家信息和商品信息

请求地址

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

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

请求语法

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

请求头

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

请求参数

字段名	类型	必填	说明
current	int	否	当前页码，默认为1
pageSize	int	否	每页显示数量，默认为10

响应头

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

返回参数

字段名	类型	说明
code	int	错误码
msg	string	错误原因说明
data	object[]	分销订单列表数组
total	int	总记录数

data 结果 item 参数

字段名	类型	说明
id	int	订单ID
order_id	string	订单号
payment_id	string	支付流水ID
user_id	int	用户ID
remark	string	订单备注
type	string	订单类型
origin_amount	int	订单原始总价（单位：分）
amount	int	订单实际总价（单位：分）
paid_time	int	支付时间戳，未支付为0
end_time	int	订单预计自动完成时间戳
deliver_time	int	发货时间戳，未发货为0
finished_time	int	订单完成时间戳，未完成为0
discount_amount	int	优惠金额（单位：分）
seller_id	int	卖家ID
seller_amount	int	卖家可得收益（单位：分）
share_user_id	int	推广者ID（即当前分销员ID）
share_parent_user_id	int	推广者上级ID
share_amount	int	推广者可得收益（单位：分）
share_parent_amount	int	推广者上级可得收益（单位：分）
express_company	string	快递公司
tracking_number	string	快递运单号
user	object	买家用户信息
details	object[]	订单详情信息列表
created_time	int	下单时间戳
status	int	订单状态：-1 取消，0 待付款，1 已付款，2 已发货，3 已完成，8 退款中，9 已退款
refund_status	int	退款状态：-1 退款失败，0 无或退款中，1 已退款

user 买家用户信息参数

字段名	类型	说明
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	是否是分销员
balance	int	用户余额（单位：分）
total_reward	int	分销员累计收益（单位：分）
invite_code	string	用户邀请码
last_login	int	最近一次登录时间戳
expire_time	int	过期时间戳
created_time	int	注册时间戳
updated_time	int	更新时间戳
status	int	用户显示状态

details 订单详情信息参数

字段名	类型	说明
id	int	订单详情ID
order_id	string	订单号
user_id	int	用户ID
goods_id	int	商品ID
goods_item_id	int	商品SKU ID
price	int	商品价格（单位：分）
origin_price	int	商品原价（单位：分）
amount	int	商品实际总价（单位：分）
origin_amount	int	商品原始总价（单位：分）
quantity	int	商品数量
status	int	状态
goods	object	商品详细信息

goods 商品详细信息参数

字段名	类型	说明
id	int	文档ID
title	string	文档标题
seo_title	string	文档SEO标题
url_token	string	文档URL别名
keywords	string	文档关键词
description	string	文档简介
module_id	int	文档模型ID
category_id	int	文档分类ID
views	int	文档浏览量
comment_count	int	文档评论量
images	string[]	文档组图
logo	string	文档Logo
thumb	string	文档缩略图
canonical_url	string	canonical URL
fixed_link	string	文档固定链接
created_time	int	文档发布时间戳
updated_time	int	文档更新时间戳
status	int	文档显示状态
user_id	int	用户ID
price	int	价格（单位：分）
stock	int	库存量

使用示例

请求示例

GET /api/retailer/orders?current=1&pageSize=10 HTTP/1.1
Host: www.anqicms.com

响应示例

{
  "code": 0,
  "msg": "",
  "data": [
    {
      "id": 46,
      "created_time": 1669212548,
      "updated_time": 1669212548,
      "order_id": "202211232209080046",
      "payment_id": "202211232209080016",
      "user_id": 1000,
      "address_id": 0,
      "remark": "英文外贸响应式通用主题wzl-008等",
      "type": "goods",
      "status": 1,
      "refund_status": 0,
      "origin_amount": 9900,
      "amount": 9900,
      "paid_time": 1669212548,
      "end_time": 0,
      "deliver_time": 0,
      "finished_time": 0,
      "discount_amount": 0,
      "seller_id": 15,
      "seller_amount": 7920,
      "share_user_id": 1000,
      "share_parent_user_id": 0,
      "share_amount": 1980,
      "share_parent_amount": 0,
      "express_company": "",
      "tracking_number": "",
      "user": {
        "id": 1001,
        "created_time": 1669012062,
        "updated_time": 1679536756,
        "parent_id": 0,
        "user_name": "customer1",
        "real_name": "",
        "avatar_url": "",
        "email": "customer1@example.com",
        "phone": "13800138000",
        "group_id": 2,
        "status": 1,
        "is_retailer": 0,
        "balance": 0,
        "total_reward": 0,
        "invite_code": "customer123",
        "last_login": 1702912236,
        "expire_time": 1997404800
      },
      "details": [
        {
          "id": 16,
          "created_time": 1669212548,
          "updated_time": 1669212548,
          "order_id": "202211232209080046",
          "user_id": 1000,
          "goods_id": 188,
          "goods_item_id": 0,
          "price": 9900,
          "origin_price": 9900,
          "amount": 9900,
          "origin_amount": 9900,
          "quantity": 1,
          "status": 1,
          "goods": {
            "id": 188,
            "created_time": 1669122751,
            "updated_time": 1669122751,
            "title": "英文外贸响应式通用主题wzl-008",
            "seo_title": "",
            "url_token": "ywwmxystyztw0-7",
            "keywords": "英文外贸响应式通用主题wzl-008",
            "description": "英文主题，外贸主题，响应式主题，通用英文企业站主题",
            "module_id": 3,
            "category_id": 36,
            "views": 158,
            "comment_count": 0,
            "images": [
              "https://www.anqicms.com/uploads/202211/22/6315f8a943b979a4.webp",
              "https://www.anqicms.com/uploads/202211/22/c705ba844eb51aec.webp"
            ],
            "status": 1,
            "canonical_url": "",
            "fixed_link": "",
            "user_id": 15,
            "price": 9900,
            "stock": 9999999,
            "logo": "https://www.anqicms.com/uploads/202211/22/6315f8a943b979a4.webp",
            "thumb": "https://www.anqicms.com/uploads/202211/22/thumb_6315f8a943b979a4.webp",
            "link": "https://www.anqicms.com/endesign/188.html"
          }
        }
      ]
    }
  ],
  "total": 1
}

错误代码

错误码	说明
0	OK
-1	错误，错误原因在 msg 中指出
1001	未登录
1002	未授权（当前用户不是分销员）
200	API 请求 OK