Files

apple 079076a70e miao33: 从 main 同步 single_uniapp22miao，dart-sass 兼容修复，DEPLOY.md 更新

- 从 main 获取 single_uniapp22miao 子项目
- dart-sass: /deep/ -> ::v-deep，calc 运算符加空格
- DEPLOY.md 采用 shccd159 版本（4 子项目架构说明）

Made-with: Cursor

2026-03-16 11:16:42 +08:00

20 KiB

Raw Permalink Blame History

H5商城网站API接口文档

API Base URL: http://miao1admin.suzhouyuqi.com
分析时间: 2025-11-08
接口协议: HTTP/HTTPS
数据格式: JSON
认证方式: Bearer Token (Header: Authori-zation)

📋 文档说明

本文档基于服务器日志 webman-2025-11-03.log 和前端编译文件分析生成，记录了H5商城网站的所有API接口。

通用说明

所有需要登录的接口都需要在请求头中携带 Token
Token 名称：Authori-zation
请求格式：application/json 或 application/x-www-form-urlencoded
响应格式：JSON

错误码说明

{
  "code": 0,     // 0=成功，非0=失败
  "msg": "提示信息",
  "data": {}     // 返回数据
}

一、用户认证接口

1.1 用户登录

接口地址: /api/user/login
请求方式: POST
是否需要登录: 否

请求参数:

参数名	类型	必填	说明
account	string	是	手机号/账号
password	string	是	密码

请求示例:

{
  "account": "18379637515",
  "password": "123456"
}

返回示例:

{
  "code": 0,
  "msg": "登录成功",
  "data": {
    "token": "eyJ0eXAiOiJKV1QiLCJhbGc...",
    "user_info": {
      "id": 92564,
      "mobile": "18379637515",
      "nickname": "用户昵称",
      "avatar": "头像URL"
    }
  }
}

1.2 用户注册

接口地址: /api/user/register
请求方式: POST
是否需要登录: 否

请求参数:

参数名	类型	必填	说明
mobile	string	是	手机号
password	string	是	密码
code	string	是	短信验证码
invite_code	string	否	邀请码

1.3 获取用户信息

接口地址: /api/user/info
请求方式: POST
是否需要登录: 是

请求参数: 无

返回示例:

{
  "code": 0,
  "msg": "success",
  "data": {
    "id": 92564,
    "mobile": "18379637515",
    "nickname": "用户昵称",
    "avatar": "头像URL",
    "share_bonus": "1234.56",       // 分红余额
    "self_bonus": "789.12",         // 自购分红
    "coupon": "456.78",             // 优惠券余额
    "today_share_bonus": "123.45",  // 今日分红
    "total_share_bonus": "9876.54"  // 累计分红
  }
}

1.4 修改用户昵称

接口地址: /api/user/nickname
请求方式: POST
是否需要登录: 是

请求参数:

参数名	类型	必填	说明
nickname	string	是	新昵称

1.5 修改密码

接口地址: /api/user/changepwd
请求方式: POST
是否需要登录: 是

请求参数:

参数名	类型	必填	说明
old_password	string	是	原密码
new_password	string	是	新密码
code	string	是	短信验证码

二、商品相关接口

2.1 获取商品分类

接口地址: /api/goods/category
请求方式: GET
是否需要登录: 否

请求参数: 无

返回示例:

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "id": 1,
      "name": "分类名称"
    }
  ]
}

2.2 获取商品列表

接口地址: /api/goods/list
请求方式: GET
是否需要登录: 否

请求参数:

参数名	类型	必填	说明
cate_id	int	是	分类ID

返回示例:

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "id": 1,
      "title": "商品标题",
      "images": ["图片1", "图片2"],
      "price": "199.00",
      "line_price": "299.00",
      "sales_volume": 1000
    }
  ]
}

2.3 获取商品详情

接口地址: /api/goods/detail
请求方式: GET
是否需要登录: 否

请求参数:

参数名	类型	必填	说明
id	int	是	商品ID

返回示例:

{
  "code": 0,
  "msg": "success",
  "data": {
    "id": 2,
    "title": "商品标题",
    "images": ["图片1", "图片2"],
    "price": "199.00",
    "line_price": "299.00",
    "sales_volume": 1000,
    "content": "商品详情",
    "customer_service": "客服微信"
  }
}

三、订单相关接口

3.1 订单首页数据

接口地址: /api/order/index
请求方式: POST
是否需要登录: 是

请求参数: 无

返回示例:

{
  "code": 0,
  "msg": "success",
  "data": {
    "shop_name": "商城名称",
    "open_week": "1,2,3,4,5",      // 开放星期
    "start_time": "09:00",          // 开始时间
    "end_time": "21:00",            // 结束时间
    "goods_id": "1",                // 商品ID
    "goods_image": "商品图片",
    "goods_setting": {              // 商品配置
      "max_buy": 3                  // 最大购买数量
    }
  }
}

3.2 可购买商品列表

接口地址: /api/order/goods
请求方式: GET
是否需要登录: 是

请求参数:

参数名	类型	必填	说明
page	int	是	页码
limit	int	是	每页数量

返回示例:

{
  "code": 0,
  "msg": "success",
  "data": {
    "total": 100,
    "list": [
      {
        "id": 143657,
        "title": "商品标题",
        "image": "商品图片",
        "price": "199.00",
        "user_id": 92467,
        "nickname": "卖家昵称",
        "created_at": "2025-11-03 09:00:00"
      }
    ]
  }
}

3.3 购买商品（抢单）

接口地址: /api/order/buy
请求方式: POST
是否需要登录: 是

请求参数:

参数名	类型	必填	说明
id	int	是	寄卖商品ID
seller_id	int	是	卖家用户ID

请求示例:

{
  "id": 143657,
  "seller_id": 92467
}

3.4 订单列表

接口地址: /api/order/list
请求方式: GET
是否需要登录: 是

请求参数:

参数名	类型	必填	说明
cate	int	是	分类：1=买方仓库，2=卖方仓库
type	int	是	类型：1=寄卖中/交易中，2=已完成
page	int	是	页码
limit	int	是	每页数量

返回示例:

{
  "code": 0,
  "msg": "success",
  "data": {
    "total": 50,
    "list": [
      {
        "id": 148674,
        "order_sn": "订单号",
        "merchandise_id": 143657,
        "merchandise_title": "商品标题",
        "merchandise_image": "商品图片",
        "total_money": "199.00",
        "status": 1,                    // 0=待支付，1=已支付，2=已完成
        "buyer_nickname": "买家昵称",
        "seller_nickname": "卖家昵称",
        "created_at": "2025-11-03 09:00:00",
        "pay_time": "2025-11-03 09:01:00",
        "confirm_time": "2025-11-03 09:10:00"
      }
    ]
  }
}

3.5 订单详情

接口地址: /api/order/detail
请求方式: GET
是否需要登录: 是

请求参数:

参数名	类型	必填	说明
order_id	int	是	订单ID

返回示例:

{
    "code": 0,
    "data": {
        "id": 149514,
        "old_id": null,
        "seller_id": 92680,
        "buyer_id": 92679,
        "order_sn": "97629117627810895214",
        "total_money": "22816.03",
        "pay_time": null,
        "pay_img": null,
        "status": 0,
        "is_resell": 0,
        "is_show": 1,
        "is_cancel": 0,
        "consignee": null,
        "phone": null,
        "province": null,
        "city": null,
        "area": null,
        "address": null,
        "merchandise_id": 144750,
        "confirm_time": null,
        "buy_time": "2025-11-10 21:24:49",
        "created_at": "2025-11-10 21:24:49",
        "updated_at": "2025-11-10 21:24:49",
        "buy_ip": "116.230.253.100",
        "cancel_ip": null,
        "goods": {
            "id": 144750,
            "title": "鲜锋活力宝",
            "image": "\/upload\/image\/20250914\/44d45afc28b6dfb47c20d127a7b64540_68c69ec7a6b0a.jpg"
        },
        "buyer": {
            "nickname": "潘1陈1勇",
            "mobile": "18621810000"
        },
        "seller": {
            "nickname": "李占明",
            "mobile": "19033999931"
        }
    },
    "msg": "成功"
}

3.6 支付订单

接口地址: /api/order/pay
请求方式: POST
是否需要登录: 是

请求参数:

参数名	类型	必填	说明
order_id	int	是	订单ID
address_id	int	是	收货地址ID

请求示例:

{
  "order_id": 148674,
  "address_id": 2911
}

3.7 确认订单（卖家发货）

接口地址: /api/order/confirm
请求方式: POST
是否需要登录: 是

请求参数:

参数名	类型	必填	说明
order_id	int	是	订单ID

请求示例:

{
  "order_id": 148674
}

3.8 取消订单

接口地址: /api/order/cancel
请求方式: POST
是否需要登录: 是

请求参数:

参数名	类型	必填	说明
order_id	int	是	订单ID

3.9 转卖订单

接口地址: /api/order/resell
请求方式: POST
是否需要登录: 是

请求参数:

参数名	类型	必填	说明
order_id	int	是	订单ID

四、地址管理接口

4.1 地址列表

接口地址: /api/address/list
请求方式: GET
是否需要登录: 是

请求参数: 无

返回示例:

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "id": 2911,
      "consignee": "收货人",
      "phone": "13584195313",
      "province": "江苏省",
      "city": "无锡市",
      "area": "锡山区",
      "address": "中大诺卡小镇",
      "is_default": 1
    }
  ]
}

4.2 获取默认地址

接口地址: /api/address/default
请求方式: POST
是否需要登录: 是

请求参数: 无

返回示例:

{
  "code": 0,
  "msg": "success",
  "data": {
    "id": 2911,
    "consignee": "收货人",
    "phone": "13584195313",
    "province": "江苏省",
    "city": "无锡市",
    "area": "锡山区",
    "address": "中大诺卡小镇",
    "is_default": 1
  }
}

4.3 新增地址

接口地址: /api/address/insert
请求方式: POST
是否需要登录: 是

请求参数:

参数名	类型	必填	说明
consignee	string	是	收货人
phone	string	是	手机号
province	string	是	省
city	string	是	市
area	string	是	区
address	string	是	详细地址
is_default	int	否	是否默认：0=否，1=是

4.4 更新地址

接口地址: /api/address/update
请求方式: POST
是否需要登录: 是

请求参数:

参数名	类型	必填	说明
id	int	是	地址ID
consignee	string	是	收货人
phone	string	是	手机号
province	string	是	省
city	string	是	市
area	string	是	区
address	string	是	详细地址
is_default	int	否	是否默认：0=否，1=是

4.5 删除地址

接口地址: /api/address/delete
请求方式: POST
是否需要登录: 是

请求参数:

参数名	类型	必填	说明
id	int	是	地址ID

五、财务相关接口

5.1 财务记录列表

接口地址: /api/money/list
请求方式: GET
是否需要登录: 是

请求参数:

参数名	类型	必填	说明
cate	int	是	分类：1=分红明细，2=优惠券明细，3=自购分红明细
type	int	是	类型：1=收入，2=支出
page	int	是	页码
limit	int	是	每页数量

返回示例:

{
  "code": 0,
  "msg": "success",
  "data": {
    "total": 100,
    "list": [
      {
        "id": 1234,
        "type": 1,              // 1=收入，2=支出
        "money": "123.45",
        "before": "1000.00",    // 变动前余额
        "after": "1123.45",     // 变动后余额
        "memo": "今日收益",
        "created_at": "2025-11-03 09:00:00"
      }
    ]
  }
}

5.2 提现记录

接口地址: /api/money/log
请求方式: GET
是否需要登录: 是

请求参数:

参数名	类型	必填	说明
page	int	是	页码
limit	int	是	每页数量

5.3 申请提现

接口地址: /api/money/withdraw
请求方式: POST
是否需要登录: 是

请求参数:

参数名	类型	必填	说明
type	int	是	提现类型：1=分红，2=优惠券
money	string	是	提现金额

六、支付相关接口

6.1 获取支付宝信息

接口地址: /api/alipay/index
请求方式: GET
是否需要登录: 是

请求参数: 无

返回示例:

{
  "code": 0,
  "msg": "success",
  "data": {
    "id": 123,
    "alipay_account": "支付宝账号",
    "alipay_name": "支付宝姓名"
  }
}

6.2 绑定支付宝

接口地址: /api/alipay/bind
请求方式: POST
是否需要登录: 是

请求参数:

参数名	类型	必填	说明
alipay_account	string	是	支付宝账号
alipay_name	string	是	支付宝姓名

6.3 获取银行卡信息

接口地址: /api/bank/index
请求方式: GET
是否需要登录: 是

请求参数: 无

返回示例:

{
  "code": 0,
  "msg": "success",
  "data": {
    "id": 123,
    "bank_name": "银行名称",
    "bank_account": "银行卡号",
    "account_name": "持卡人姓名"
  }
}

七、分享推广接口

7.1 分享首页数据

接口地址: /api/share/index
请求方式: GET
是否需要登录: 是

请求参数: 无

返回示例:

{
  "code": 0,
  "msg": "success",
  "data": {
    "invite_code": "ABC123",        // 邀请码
    "direct_count": 10,             // 直推人数
    "team_count": 50,               // 团队人数
    "share_link": "https://..."     // 分享链接
  }
}

7.2 我的粉丝列表

接口地址: /api/share/select
请求方式: GET
是否需要登录: 是

请求参数:

参数名	类型	必填	说明
page	int	是	页码
limit	int	是	每页数量

返回示例:

{
  "code": 0,
  "msg": "success",
  "data": {
    "total": 20,
    "list": [
      {
        "id": 92490,
        "avatar": "头像",
        "nickname": "用户昵称",
        "mobile": "138****1234",
        "team_count": 5,            // 下级团队人数
        "created_at": "2025-11-03 09:00:00"
      }
    ]
  }
}

八、首页相关接口

8.1 轮播图

接口地址: /api/index/banner
请求方式: GET
是否需要登录: 否

请求参数: 无

返回示例:

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "id": 1,
      "image": "轮播图URL",
      "url": "跳转链接"
    }
  ]
}

8.2 首页配置数据

接口地址: /api/index/get
请求方式: POST
是否需要登录: 否

请求参数:

参数名	类型	必填	说明
title	string	是	配置标题，如"公告消息"

请求示例:

{
  "title": "公告消息"
}

返回示例:

{
  "code": 0,
  "msg": "success",
  "data": {
    "value": "公告内容"
  }
}

九、短信相关接口

9.1 发送短信验证码

接口地址: /api/sms/send
请求方式: POST
是否需要登录: 否

请求参数:

参数名	类型	必填	说明
mobile	string	是	手机号
event	string	是	事件类型：register=注册，resetpwd=重置密码，changepwd=修改密码

请求示例:

{
  "mobile": "13585643985",
  "event": "resetpwd"
}

返回示例:

{
  "code": 0,
  "msg": "短信发送成功"
}

十、其他接口

10.1 签名回调

接口地址: /api/notify/sign
请求方式: POST
是否需要登录: 否

说明: 第三方签名回调接口

📊 接口汇总表

模块	接口数量	说明
用户认证	5	登录、注册、信息获取、修改
商品管理	3	分类、列表、详情
订单管理	9	下单、支付、发货、取消等
地址管理	5	增删改查、默认地址
财务管理	3	明细、提现
支付管理	3	支付宝、银行卡
分享推广	2	分享数据、粉丝列表
首页相关	2	轮播图、配置
短信服务	1	验证码发送
总计	33	全部接口

🔐 Token 说明

获取 Token

用户登录成功后，响应数据中会返回 token 字段。

使用 Token

在需要登录的接口请求头中携带：

Authori-zation: Bearer eyJ0eXAiOiJKV1QiLCJhbGc...

注意: Header 名称是 Authori-zation (不是标准的 Authorization)

⚙️ 业务逻辑说明

订单状态流程

待支付 (status=0): 买家抢单成功，但未支付
已支付 (status=1): 买家已支付，等待卖家发货确认
已完成 (status=2): 卖家确认发货，订单完成，开始分红

订单分类

买方仓库 (cate=1): 我购买的商品订单
卖方仓库 (cate=2): 我寄卖的商品订单

财务分类

分红余额 (share_bonus): 推广分红
自购分红 (self_bonus): 自购返利
优惠券 (coupon): 优惠券余额

短信事件类型

register: 注册
resetpwd: 重置密码
changepwd: 修改密码

🧪 测试示例

登录测试

curl -X POST http://miao1admin.suzhouyuqi.com/api/user/login \
  -H "Content-Type: application/json" \
  -d '{
    "account": "18379637515",
    "password": "123456"
  }'

获取用户信息

curl -X POST http://miao1admin.suzhouyuqi.com/api/user/info \
  -H "Content-Type: application/json" \
  -H "Authori-zation: Bearer YOUR_TOKEN"

获取商品列表

curl "http://miao1admin.suzhouyuqi.com/api/goods/list?cate_id=1"

订单列表（卖方仓库）

curl "http://miao1admin.suzhouyuqi.com/api/order/list?cate=2&type=1&page=1&limit=10" \
  -H "Authori-zation: Bearer YOUR_TOKEN"

📝 注意事项

认证头名称: 注意是 Authori-zation 而非标准的 Authorization
POST 方法: 某些查询接口如 /api/user/info、/api/order/index 使用 POST 方法
限流机制: 部分接口有访问频率限制，使用 Redis 实现
营业时间: 商品购买受营业时间限制（通过 open_week、start_time、end_time 控制）
防重复提交: 关键操作（购买、支付、确认）有防重复提交机制

📅 更新日志

2025-11-08: 基于 webman-2025-11-03.log 日志完整分析，新增 33 个接口文档

20 KiB Raw Permalink Blame History Unescape Escape

H5商城网站API接口文档

📋 文档说明

通用说明

错误码说明

目录

一、用户认证接口

1.1 用户登录

1.2 用户注册

1.3 获取用户信息

1.4 修改用户昵称

1.5 修改密码

二、商品相关接口

2.1 获取商品分类

2.2 获取商品列表

2.3 获取商品详情

三、订单相关接口

3.1 订单首页数据

3.2 可购买商品列表

3.3 购买商品（抢单）

3.4 订单列表

3.5 订单详情

3.6 支付订单

3.7 确认订单（卖家发货）

3.8 取消订单

3.9 转卖订单

四、地址管理接口

4.1 地址列表

4.2 获取默认地址

4.3 新增地址

4.4 更新地址

4.5 删除地址

五、财务相关接口

5.1 财务记录列表

5.2 提现记录

5.3 申请提现

六、支付相关接口

6.1 获取支付宝信息

6.2 绑定支付宝

6.3 获取银行卡信息

七、分享推广接口

7.1 分享首页数据

7.2 我的粉丝列表

八、首页相关接口

8.1 轮播图

8.2 首页配置数据

九、短信相关接口

9.1 发送短信验证码

十、其他接口

10.1 签名回调

📊 接口汇总表

🔐 Token 说明

获取 Token

使用 Token

⚙️ 业务逻辑说明

订单状态流程

订单分类

财务分类

短信事件类型

🧪 测试示例

登录测试

获取用户信息

获取商品列表

订单列表（卖方仓库）

📝 注意事项

📅 更新日志

20 KiB

Raw Permalink Blame History