Files
shaguabijia-app-server/docs/api/meituan-referral-link.md
OuYingJun1024 3d1e8969e6 docs: 新建 docs/integrations 集成层文档 + api 文档变薄
- 新增 docs/integrations/(README + jiguang/sms/meituan/pangle/wxpay 各一篇):
  记录各 SDK 集成的签名/验签/加解密/协议细节与踩坑(对齐 app/integrations 分层)
- docs/api 接口文档变薄: 受影响接口头部加「集成实现」链接,把验签/RSA/CPS 签名
  等重逻辑描述移到集成文档;ad-pangle-callback 验签段精简为指针
- docs/api/README 补架构说明(api 薄 / 重逻辑在 integrations)
- 后端技术实现.md 目录树补全(福利/钱包/签到/省钱/发奖端点 + crud/integrations 现状),
  pangle/wxpay 标注移入 integrations
- ad_reward_golive_checklist 路径同步 core→integrations

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-27 20:45:12 +08:00

1.3 KiB
Raw Permalink Blame History

POST /api/v1/meituan/referral-link — 换取推广链接

所属:美团 CPS 组(前缀 /api/v1/meituan,全部无鉴权 | 鉴权:无 | ← 返回 API 索引

集成实现:见 integrations/meituan(CPS S-Ca 签名、入参换算坑)。

入参

字段 类型 必填 默认 说明
product_view_sign string 券的换链主键(来自 CouponCard
platform int 1 1=外卖/到家, 2=到店
biz_line int null 到店子类
sid string 服务端默认 sgbjia 渠道追踪标识
link_type_list int[] [1, 3] 1=H5长链 2=H5短链 3=deeplink

出参

响应 200:

字段 类型 说明
link string 默认推广链接(按 data > H5(1) > deeplink(3) > 任意 兜底)
link_map object 各类型链接 { "linkType": "url" },如 {"1": "<H5>", "3": "<deeplink>"}

错误码

  • 502 美团接口失败

说明

客户端实际优先用 link_map["3"]deeplink)拉起美团 App,失败降级 link_map["1"]H5)。

⚠️ 安全:sid 允许客户端传值覆盖服务端默认渠道,理论上他人可借本接口刷自己渠道的分佣;建议服务端锁定 sid、忽略客户端传值。