货源大厅
1. 获取货源大厅列表
接口地址： /merchantapi/distribution/hall/list
请求方式： POST
权限要求： 会验证货源大厅访问权限及信誉分≥80
请求参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| need_apply | int | 否 | 审核模式：0=自动通过，1=需审核 |
| keyword | string | 否 | 搜索关键词（搜索名片名称） |
| card_level | int | 否 | 名片等级筛选：-1=全部，0-n=具体等级（默认-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, // 信誉值
"rating_score": 96, // 店铺评分（用于名片预览显示）~~新增于 2025-12-20~~
"is_quality": 0, // 是否为优质商家 0否 1是
"goods_count": 4, // 商品数量
"card_level": 2, // 名片等级 ~~新增于 2025-12-20~~
"card_style_info": { // 名片样式信息 ~~新增于 2025-12-20~~
"title": "黄金",
"level": 2,
"card_style": "...",
"text_style": "...",
"title_style": "...",
"level_style": "..."
},
"badge_info": { // 标签信息 ~~新增于 2025-12-20~~
"key": "rating",
"name": "综合评分",
"icon": "..."
}
}
],
"total": 2
}
}2. 获取商户商品列表
接口地址： /merchantapi/distribution/hall/goodsList
请求方式： POST
权限要求： 会验证货源大厅访问权限及信誉分≥80
请求参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | int | 是 | 商户ID |
| category_id | int | 否 | 商品分类ID(2025-12-15新增)， 不传或0表示全部 |
| keyword | string | 否 | 商品名称搜索关键词 |
| page | int | 否 | 页码 |
| limit | int | 否 | 每页数量 |
响应示例：
json
{
"code": 1,
"msg": "获取成功",
"data": {
"list": [
{
"id": 1,
"cate_id": 1, // 商品分类ID
"cate_name": "xxx", // 商品分类名称 2025-12-15新增
"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, // 库存数量（~~更新于 2025-12-20：改为真实库存~~）
"shop_name": "1001小店", // 店铺名
"is_docked": 0, // 是否已对接：0=未对接，1=已对接
"is_blacklist": 0 // 是否在黑名单：0=否，1=是。建议1时前端做成对接按钮为无权限
}
],
"total": 1
}
}2.1 获取上级存在货源大厅商品的分类
- 2025-12-15 新增
接口地址： /merchantapi/distribution/hall/getCategoryTree
请求方式： POST
请求参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | int | 是 | 商户ID |
响应示例：
json
{
"code": 1,
"msg": "获取成功",
"data": [
{
"value": 4, // 栏目id
"label": "11111111", // 栏目名
"children": []
},
{
"value": 5,
"label": "测试",
"children": []
}
]
}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. 搜索商品
更新于 2025-12-20：新增名片等级筛选、名片样式信息、标签信息、代理状态等返回字段
接口地址： /merchantapi/distribution/hall/searchGoods
请求方式： POST
请求参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| keyword | string | 是 | 搜索关键词 |
| card_level | int | 否 | 名片等级筛选：-1=全部，0-n=具体等级（默认-1） |
| page | int | 否 | 页码 |
| limit | int | 否 | 每页数量 |
响应示例：
json
{
"code": 1,
"msg": "获取成功",
"data": {
"list": [
{
"id": 8,
"cate_id": 3,
"cate_name": "分类名称", // ~~新增于 2025-12-20~~
"user_id": 1004,
"sort": 0,
"name": "商品名称",
"hall_price": "8.00",
"content": "商品描述...",
"status": 1,
"create_at": "2025-11-23 20:56:24",
"is_freeze": 0,
"can_proxy": 1,
"stock_quantity": 0,
"shop_name": "ovo小店",
"username": "test1004",
"card_level": 2, // 名片等级 ~~新增于 2025-12-20~~
"hall_name": "名片名称", // ~~新增于 2025-12-20~~
"need_apply": 0, // 是否需要审核 ~~新增于 2025-12-20~~
"rating_score": 96, // 店铺评分 ~~新增于 2025-12-20~~
"is_docked": 0, // 是否已对接 ~~新增于 2025-12-20~~
"is_blacklist": 0, // 是否在黑名单 ~~新增于 2025-12-20~~
"agent_status": "none", // 代理申请状态：none=未申请, pending=申请中, approved=已通过, rejected=已拒绝 ~~新增于 2025-12-20~~
"card_style_info": { // 名片样式信息 ~~新增于 2025-12-20~~
"title": "黄金",
"level": 2,
"card_style": "...",
"text_style": "...",
"title_style": "...",
"level_style": "..."
},
"badge_info": { // 标签信息 ~~新增于 2025-12-20~~
"key": "rating",
"name": "综合评分",
"icon": "..."
}
}
],
"total": 2
}
}说明： 搜索商品名称和商品说明，更新于 2025-12-20：按名片等级降序排列
响应示例：
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
}
}说明： 搜索商品名称和商品说明