1. 霸王餐渠道活动接口
霸王餐渠道接口
  • 业务流程
  • 订单通知
  • 接口安全
  • 霸王餐渠道活动接口
    • 霸王餐类目列表
      GET
    • 霸王餐活动详情
      GET
    • 霸王餐活动分页列表
      GET
  • 霸王餐渠道订单接口
    • 渠道报名下单
      POST
    • 渠道取消报名
      POST
    • 渠道订单详情
      GET
    • 渠道报名单分页搜索
      GET
    • 回填外卖单号
      POST
    • 上传凭证
      POST
  • 霸王餐连通性接口
    • 连通性验证
      GET
  • 数据模型
    • ApiResponse«List«霸王餐类目»»
    • ApiResponse«Map«string,object»»
    • ApiResponse«PageResponse«霸王餐渠道订单»»
    • ApiResponse«PageResponse«霸王餐门店»»
    • ApiResponse«Void»
    • ApiResponse«霸王餐活动详情»
    • ApiResponse«霸王餐渠道订单»
    • BwcUserOrderInfo
    • PageResponse«霸王餐渠道订单»
    • PageResponse«霸王餐门店»
    • 上传凭证请求
    • 回填外卖单号请求
    • 渠道取消报名请求
    • 渠道报名下单请求
    • 霸王餐活动条目
    • 霸王餐活动详情
    • 霸王餐渠道订单
    • 霸王餐类目
    • 霸王餐门店
  1. 霸王餐渠道活动接口

霸王餐活动分页列表

GET
/openapi/bwc/activity/search
霸王餐活动分页列表(门店维度,一店多活动内嵌 activities)。
调用时机:渠道列表页拉取可推广活动;支持按城市/坐标/关键词/类目/返利模式筛选与排序。
筛选规则:rebateMode 不传或非法值=全部;category 为类目枚举 name 逗号分隔,非法值忽略;sort 为 Smart(智能,默认)/HighRebate(高返利)/Distance(距离最近,需传坐标);onlyGrab=true 只看可抢。分页 page 从 0 起,size 1-100(默认 20,超过按 100 处理)。传经纬度时返回 distanceMeters 与 inRange。
所有接口一律返回 HTTP 200,成败看 body.code:0 成功 / 3 参数错误(含时间窗、nonce 重复) / 101 签名不匹配 / 300 业务参数错误 / 301 业务校验失败 / 500 服务端或上游异常。
公共签名参数 appId/timestamp/nonce/sign 可放 URL query 或 header;签名算法:URL 参数与 body 顶层字段合并(URL 覆盖 body,剔除 sign),扁平化后按 key 字典序拼接 k1=v1&k2=v2,空值跳过,末尾直拼 secret 后取 MD5 32 位小写(UTF-8)。金额单位一律为分,比例万分比(500=5%)。
用户身份:mobile 必填(渠道侧用户手机号,11 位明文,参与签名)。上游按用户身份下发/裁剪活动数据,同一坐标不同手机号结果可能不同;列表、详情、报名请使用同一号码。

请求参数

Query 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'http://prod-cn.your-api-server.com/openapi/bwc/activity/search?appId=undefined&category=HotPot%2CBarbecue&keywords=%E7%81%AB%E9%94%85&latitude=31.863916&longitude=117.285735&mobile=13800138000&nonce=undefined&onlyGrab=true&page=0&rebateMode=Auto&sign=undefined&size=20&sort=HighRebate&timestamp=undefined'

返回响应

🟢200成功
*/*
OK
Body*/*

示例
{"code": 0, "message": "success", "data": {"total": 1, "page": 0, "size": 20, "data": [{"rebateMode": "Auto", "mtCategory": "HotPot", "storeId": "store_123", "storeName": "老乡鸡(步行街店)", "storeCover": "https://cdn.example.com/cover/1.jpg", "platformCode": "mt", "longitude": 117.285735, "latitude": 31.863916, "distanceMeters": 860, "inRange": true, "score": "4.8", "monthSales": "月售 1200", "minOrderTip": "起送 ¥20", "deliveryTimeTip": "约 35 分钟送达", "appletJumpInfo": {"lpUrl": "https://..."}, "activities": [{"rebateMode": "Auto", "activityId": "act_8888", "totalProfit": 800, "rebatePrice": 600, "serviceFee": 100, "promoterProfit": 100, "remainingQuota": 12, "activeStatus": 1, "startTime": "2026-10-23 00:00:00", "endTime": "2026-10-24 23:59:59", "mealPrice": 3000, "realCharge": 2500, "needFeedback": true, "applied": false, "rebateFloatType": "Fee", "rebateThreshold": 0, "rebateCap": 500, "rebateRate": 0, "memberRebatePrice": 0, "memberRebateRate": 0, "userOrderInfo": null}]}]}}
🟠401没有权限
🟠403禁止访问
🟠404记录不存在
修改于 2026-10-30 11:29:16
上一页
霸王餐活动详情
下一页
渠道报名下单
Built with