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/detail
霸王餐活动详情(活动主体 + 门店地址/营业时间/温馨提示等扩展)。
调用时机:用户点进活动详情页;rebateMode 必填(Auto=自动/无需上传截图,Manual=手动/需上传截图),非法值返回 301。storeName 为部分活动定位用,可选;传坐标时用于距离计算。
返回 activity.activities 为单元素列表;appletJumpInfo 为小程序跳转信息 JSON 串(含 H5 链接 lpUrl)。
所有接口一律返回 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/detail?activityId=act_8888&appId=undefined&latitude=31.863916&longitude=117.285735&mobile=13800138000&nonce=undefined&rebateMode=Auto&sign=undefined&storeName=%E8%80%81%E4%B9%A1%E9%B8%A1%EF%BC%88%E6%AD%A5%E8%A1%8C%E8%A1%97%E5%BA%97%EF%BC%89&timestamp=undefined'

返回响应

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

示例
{"code": 0, "message": "success", "data": {"activity": {"rebateMode": "Manual", "mtCategory": "HotPot", "storeId": "store_123", "storeName": "老乡鸡(步行街店)", "activities": [{"rebateMode": "Manual", "activityId": "act_8888", "rebatePrice": 600, "remainingQuota": 12, "activeStatus": 1, "mealPrice": 3000, "needFeedback": true, "applied": false, "rebateFloatType": "Fee", "userOrderInfo": null}]}, "storeAddress": "XX市XX区步行街 88 号", "businessHours": "10:00-22:00", "remind": "每人限参与 1 次,需上传消费凭证", "repurchaseInterval": 7, "praiseType": 1, "praiseName": "好评截图", "appletJumpInfo": {"lpUrl": "https://..."}}}
🟠401没有权限
🟠403禁止访问
🟠404记录不存在
修改于 2026-10-30 11:29:18
上一页
霸王餐类目列表
下一页
霸王餐活动分页列表
Built with