货源大厅
1. 获取货源大厅列表
接口地址： /merchantapi/distribution/hall/list
请求方式： POST
权限要求： 会验证货源大厅访问权限及信誉分≥80
请求参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| need_apply | int | 否 | 审核模式：0=自动通过，1=需审核 |
| page | int | 否 | 页码 |
| limit | int | 否 | 每页数量 |
响应示例：
json
{
"code": 1,
"msg": "获取成功",
"data": {
"list": [
{
"id": 3,
"user_id": 1004,
"name": "123", // 名片名称
"remark": "456", // 名片简介
"need_apply": 0, // 申请时需要审核代理关系：0 无需 1需要
"create_time": "2025-11-23 22:55:26", // 创建时间
"update_time": "2025-11-24 15:56:52", // 更新时间
"refresh_time": 1763971012, // 刷新时间
"username": "test1004", // 商户名
"shop_name": "ovo小店", // 店铺名
"credit_score": 96, // 信誉值
"is_quality": 0, // 是否为优质商家 0否 1是
"goods_count": 4 // 商品数量
},
],
"total": 2
}
}2. 获取商户商品列表
接口地址： /merchantapi/distribution/hall/goodsList
请求方式： POST
权限要求： 会验证货源大厅访问权限及信誉分≥80
请求参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | int | 是 | 商户ID |
| page | int | 否 | 页码 |
| limit | int | 否 | 每页数量 |
响应示例：
json
{
"code": 1,
"msg": "获取成功",
"data": {
"list": [
{
"id": 1,
"cate_id": 1,
"user_id": 1000,
"sort": 0,
"name": "1000的商品1",
"hall_price": "18.00", // 货源大厅价格
"content": "<p><span style=\"color: rgba(0, 0, 0, 0.9); background-color: rgb(255, 255, 255); font-size: 12px;\">商品描述q</span></p>", // 商品描述
"status": 1, // 状态：0=下架，1=上架
"create_at": "2025-11-19 00:50:55", // 创建时间
"can_proxy": 1, // 是否可代理：0=不可，1=可以
"stock_quantity": 480, // 库存数量
"shop_name": "1001小店", // 店铺名
"is_docked": 0, // 是否已对接：0=未对接，1=已对接
"is_blacklist": 0, // 是否在黑名单：0=否，1=是。建议1时前端做成对接按钮为无权限
}
],
"total": 1
}
}3. 获取代理状态
接口地址： /merchantapi/distribution/hall/agentStatus
请求方式： POST
请求参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | int | 是 | 商户ID |
响应示例：
json
{
"code": 1,
"msg": "获取成功",
"data": {
"status": "none" // 代理状态：none=未申请，pending=待审核，approved=已通过，rejected=已拒绝
}
}4. 申请成为代理
接口地址： /merchantapi/distribution/hall/becomeAgent
请求方式： POST
权限要求： 需要货源大厅访问权限
请求参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | int | 是 | 商户ID |
响应示例：
json
{
"code": 1,
"msg": "成为代理成功",
"data": {
"status": 1, // 状态：0=失败，1=成功
"result": "成为代理成功"
}
}业务规则：
- 不能对接自己
- 名片必须存在且开启
- 根据名片设置决定是否需要审核
- 自动通过：status=1
- 需要审核：status=0
5. 搜索商品
接口地址： /merchantapi/distribution/hall/searchGoods
请求方式： POST
请求参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| keyword | string | 是 | 搜索关键词 |
| page | int | 否 | 页码 |
| limit | int | 否 | 每页数量 |
响应示例：
json
{
"code": 1,
"msg": "获取成功",
"data": {
"list": [
{
"id": 8,
"cate_id": 3,
"user_id": 1004,
"sort": 0,
"name": "谁的青春不励志，得言精心整理，100句人生励志语录1、你只管努力，剩下的交给时间。 谁的青春不励志，得言精心整理，100句人生励志语录1、你只管努力，剩下的交给时间。",
"hall_price": "8.00",
"content": "<ul><li style=\"text-align: start;\">“成功不是终点，而失败并不致命：有勇气继续下去才是最重要的。”—— ...</li><li style=\"text-align: start;\">“宁可在独创性上失败，也不要在模仿中成功。”—— ...</li><li style=\"text-align: start;\">“成功之路和失败之路几乎是相同的。”—— ...</li><li style=\"text-align: start;\">“成功通常属于那些忙于寻找成功的人。”—— ...</li><li style=\"text-align: start;\">“学会从失败中成功。 ...</li><li style=\"text-align: start;\">“这个世界上，坚持不懈是无可替代的。</li></ul>",
"status": 1,
"create_at": "2025-11-23 20:56:24",
"is_freeze": 0,
"can_proxy": 1,
"stock_quantity": 0,
"shop_name": "ovo小店",
"username": "test1004"
},
{
"id": 6,
"cate_id": 7,
"user_id": 1002,
"sort": 0,
"name": "谁的青春不励志，得言精心整理，100句人生励志语录1、你只管努力，剩下的交给时间。 谁的青春不励志，得言精心整理，100句人生励志语录1、你只管努力，剩下的交给时间。",
"hall_price": "20.00",
"content": "<ul><li style=\"text-align: start;\">“成功不是终点，而失败并不致命：有勇气继续下去才是最重要的。”—— ...</li><li style=\"text-align: start;\">“宁可在独创性上失败，也不要在模仿中成功。”—— ...</li><li style=\"text-align: start;\">“成功之路和失败之路几乎是相同的。”—— ...</li><li style=\"text-align: start;\">“成功通常属于那些忙于寻找成功的人。”—— ...</li><li style=\"text-align: start;\">“学会从失败中成功。 ...</li><li style=\"text-align: start;\">“这个世界上，坚持不懈是无可替代的。</li></ul>",
"status": 1,
"create_at": "2025-11-23 18:09:03",
"is_freeze": 0,
"can_proxy": 1,
"stock_quantity": 957,
"shop_name": "九头蛇",
"username": "test1002"
}
],
"total": 2
}
}说明： 搜索商品名称和商品说明