logan

Appearance

1. 获取名片设置 ​

接口地址： /merchantapi/distribution/userhall/getSetting

请求方式： POST

权限要求： 信誉分≥70

请求参数： 无

响应示例：

json
{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "id": 1,
    "user_id": 1000,
    "name": "大厅1000商家", // 名片名称
    "remark": "名片备注名片备注大厅1000商家", // 名片备注
    "refrash_count": 0, // 刷新点数量
    "card_level": 2, // 名片等级 名片页面用于查找购买过的等级
    "need_apply": 0, // 申请时需要审核代理关系：0 无需 1需要
    "status": 1, // 状态：0=下架，1=上架
    "create_time": "2025-11-19 00:54:38",
    "update_time": "2025-11-19 15:56:55",
    "refresh_time": null, // 最后刷新时间
    "close_status": 0, // 平台对此商户的开启状态；信誉分低于80时 关闭：1关闭，默认0开启，级别高于status
    "username": "test1000", // 商户名
    "shop_name": "1001小店", // 店铺名
    "is_checked_in": 0, // 今日是否已签到
    "refresh_point_price": 0.2 // 刷新点单价
  }
}

2. 设置名片信息 ​

接口地址： /merchantapi/distribution/userhall/setSetting

请求方式： POST

请求参数：

参数名类型必填说明
namestring是名片名称
remarkstring是名片备注
need_applyint是审核模式：0=自动通过，1=需审核
statusint是状态：0=关闭，1=开启

响应示例：

json
{
  "code": 1,
  "msg": "设置成功"
}

错误示例：

json
{
  "code": 0,
  "msg": "请填写名片名称"
}

错误示例：

json
{
  "code": 0,
  "msg": "请填写名片备注"
}

3. 签到获取刷新点 ​

接口地址： /merchantapi/distribution/userhall/checkIn

响应示例：

json
{
  "code": 1,
  "msg": "签到成功"
}

错误示例：

json
{
  "code": 0,
  "msg": "今天已经签到过了"
}

业务规则：

  • 每天只能签到一次
  • 签到成功获得1个刷新点
  • 记录签到日志

4. 签到记录 ​

接口地址： /merchantapi/distribution/userhall/signLog

请求方式： POST

请求参数：

参数名类型必填说明
monthstring否月份（格式：Y-m，默认当月）

响应示例：

json
{
  "code": 1,
  "msg": "获取成功",
  "data": ["2023-12-01", "2023-12-02", "2023-12-05"] // 无记录时 data项不存在
}

5. 刷新排名 ​

接口地址： /merchantapi/distribution/userhall/refreshRank

响应示例：

json
{
  "code": 1,
  "msg": "刷新成功",
  "data": {
    "refresh_point": 9 // 剩余刷新点数量
  }
}

错误示例：

json
{
  "code": 0,
  "msg": "名片不存在" // 其他 刷新点不足
}

业务规则：

  • 需要消耗1个刷新点
  • 刷新后排名靠前
  • 返回剩余刷新点数量

6. 购买刷新点 ​

接口地址： /merchantapi/distribution/userhall/buyRefreshPoint

请求方式： POST

请求参数：

参数名类型必填说明
countint是购买数量

响应示例：

json
{
  "code": 1,
  "msg": "购买成功"
}

错误示例：

json
{
  "code": 0,
  "msg": "购买数量不能小于等于0" // 其他：运营钱包余额不足，请先充值
}

业务规则：

  • 需要有足够的运营资金
  • 价格根据系统配置计算
  • 扣除运营资金并记录日志

7. 获取系统名片排名卡片列表 ​

接口地址： /merchantapi/distribution/userhall/getSystemCardStyle

响应示例：

json
{
  "code": 1,
  "msg": "获取成功",
  "data": [
    {
      "id": 3,
      "title": "测试2", // 标题
      "desc": "", // 描述
      "price": "30.00", // 价格
      "status": 1,
      "level": 5, // 等级
      "create_time": "2025-11-25 01:15:42",
      "update_time": "2025-11-25 01:17:37"
    }
  ]
}

8. 购买系统名片排名卡片 ​

接口地址： /merchantapi/distribution/userhall/buyCardStyle

请求方式： POST

请求参数：

参数名类型必填说明
system_card_idint是名片排名卡片ID

响应示例：

json
{
  "code": 1,
  "msg": "购买成功"
}

业务规则：

  • 需要有足够的运营资金
  • 购买后自动应用样式
  • 扣除运营资金并记录日志

业务规则总结 ​

1. 访问权限 ​

  • 需要核销邀请码开通访问权限
  • 信誉分必须≥80分
  • 信誉分不足时无法访问货源大厅

2. 邀请码规则 ​

  • 购买邀请码需要运营资金
  • 核销邀请码增加信誉分
  • 邀请码只能使用一次

3. 名片设置 ​

  • 信誉分≥70才能设置名片
  • 名片可以设置审核模式
  • 名片可以开启/关闭

4. 刷新点规则 ​

  • 每日签到获得1个刷新点
  • 刷新排名消耗1个刷新点
  • 可以购买刷新点

5. 代理申请 ​

  • 不能对接自己
  • 根据名片设置决定是否需要审核
  • 申请成功后可以对接商品

注意事项 ​

  • 货源大厅功能需要信誉分≥80
  • 设置名片需要信誉分≥70
  • 邀请码购买和核销会影响信誉分
  • 刷新排名需要消耗刷新点
  • 系统名片需要购买才能使用
  • 每日只能签到一次