Files
order_site/docs/抖音-码速达/接口API/03-卡券同步.md
T
yml2213 5978e92370 docs(抖音-码速达): 收录开放平台全量对接文档(抓取快照)
新增 docs/抖音-码速达:把新平台(dy-openplatform-api.wanmahui.com)联调文档页的
全部数据落到仓库,供离线查阅与后续对接。

数据来源:文档页把全部数据内嵌在隐藏 input#raw_data 的 JSON 里(api / message /
fee / menu 四块),一次请求即取全,无需逐页爬取。

内容:
- README.md:平台速览(网关、鉴权要素、计费)、14 条消息与 16 个接口总表、对接六步;
- 01-计费规则.md:免费/基础(1 金豆)/高级(2 金豆)/增值(4 金豆)四档与各接口分级;
- 02-接口调用规范与签名.md:网关 POST /api/openplatform/gateway、公共参数
  uid/method/timestamp/sign、MD5 签名算法与可复算示例、返回结构;
- 03-消息推送规范与签名.md:topic/pub_time/sign 走 URL、data 走 POST body、
  验签要点、message.config 消息设置、messagetest 测试入口;
- 接口API/ 16 篇:请求参数、返回字段(层级缩进)、可解析的返回示例 JSON、
  签名原串 + MD5 结果;
- 消息推送/ 14 篇:topic、data 字段、示例 JSON、签名原串 + MD5 结果;
- data/raw_data.json(与页面快照逐字段校验一致)、data/page.html、data/代码示例/
  (页面内置 JAVA/.NET/PHP 示例 6 份)、data/crawl-meta.json(抓取元信息与文件 MD5)。

校验:接口 16/16、消息 14/14 无缺漏,33 段示例 JSON 全部可解析,内部链接全部可达。
文档页访问令牌已隐去(凭据不入库)。04~06 的分析类文档暂不入库,仅保留本地。
2026-10-08 14:57:30 +08:00

3.2 KiB
Raw Blame History

卡券同步(coupons.syncV2)

本页数据抓取自抖音码速达开放平台「接口API → 卡券同步」。

项目 内容
接口名称 卡券同步
方法名 method coupons.syncV2
功能分级 基础功能
请求地址 POST https://dy-openplatform-api.wanmahui.com/api/openplatform/gateway
Content-Type application/x-www-form-urlencoded
说明 卖家在平台卖出券后同步卡券信息
抖店原始路径 /coupons/syncV2
抖店原始文档 卡券同步

请求参数

参数名 类型 必填 提交方式 说明
uid String 是 Post 抖店商户号(公共参数,示例 111111111)
method String 是 Post 方法名,固定为 coupons.syncV2(公共参数)
timestamp String 是 Post 秒级时间戳,10 分钟内有效(公共参数)
sign String 是 Post 签名,签名原串 MD5(小写),见「接口调用规范与签名」
order_id String 是 Post 子订单ID,示例:123421345
cert_list Json 是 Post 卡券信息列表,数组类型,以Json字符串形式传入,示例:[{"cert_link":"https://obd.gtimg.com/new-benefit-web-schema/dev/dist/index.html?ShortLinkId=6438f6f4a87f2&e=test&dyp=1&c=cafsdadsfas","cert_no":"7136xxxasd","grant_time":"2010-01-01 12:12:12"}]

嵌套参数 cert_list

卡券信息列表,数组类型,以Json字符串形式传入

提交时以 JSON 字符串整体作为一个参数值,示例:

[{"cert_link":"https://obd.gtimg.com/new-benefit-web-schema/dev/dist/index.html?ShortLinkId=6438f6f4a87f2&e=test&dyp=1&c=cafsdadsfas","cert_no":"7136xxxasd","grant_time":"2010-01-01 12:12:12"}]
参数名 类型 必填 说明
cert_link String 否 卡券跳转链接,长度限制255
cert_no String 是 卡券券码
grant_time String 是 发券时间

返回参数

(无返回参数说明)

返回示例

{
    "code": "10000",
    "message": "成功"
}

签名原串示例

除 sign 外的全部参数按参数名字典序拼接 参数名+参数值,首尾各加一次用户秘钥(这里用占位秘钥 XXXXXXXXXXXXXXXXXXXX、占位商户号 111111111、时间戳 1780000000):

XXXXXXXXXXXXXXXXXXXXcert_list[{"cert_link":"https://obd.gtimg.com/new-benefit-web-schema/dev/dist/index.html?ShortLinkId=6438f6f4a87f2&e=test&dyp=1&c=cafsdadsfas","cert_no":"7136xxxasd","grant_time":"2010-01-01 12:12:12"}]methodcoupons.syncV2order_id123421345timestamp1780000000uid111111111XXXXXXXXXXXXXXXXXXXX

参数名排序:cert_list、method、order_id、timestamp、uid

sign = md5(签名原串)(32 位小写)= e178612ad7b122104b9ec34e12fdfb9a

请求代码示例

页面内置 JAVA / .NET / PHP 三种示例代码,已原样保存:

  • data/代码示例/接口API-请求示例-JAVA.txt
  • data/代码示例/接口API-请求示例-DOTNET.txt
  • data/代码示例/接口API-请求示例-PHP.txt

第 3 / 16 个接口 | 导航: 返回索引