Files

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.9 KiB

Raw Blame History

券码查询（`coupons.list`）

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

项目	内容
接口名称	券码查询
方法名 method	`coupons.list`
功能分级	基础功能
请求地址	`POST https://dy-openplatform-api.wanmahui.com/api/openplatform/gateway`
Content-Type	`application/x-www-form-urlencoded`
说明	查询券码在平台侧的状态详情
抖店原始路径	`/coupons/list`
抖店原始文档	券码查询接口

请求参数

参数名	类型	必填	提交方式	说明
uid	String	是	Post	抖店商户号（公共参数，示例 `111111111`）
method	String	是	Post	方法名，固定为 `coupons.list`（公共参数）
timestamp	String	是	Post	秒级时间戳，10 分钟内有效（公共参数）
sign	String	是	Post	签名，签名原串 MD5（小写），见「接口调用规范与签名」
order_id	String	否	Post	子订单ID，示例：`123`
cert_no	String	否	Post	卡号券码，示例：`卡券id`
cert_type	Integer	否	Post	卡券类型：0-三方卡券，1-平台卡券，示例：`0`

返回参数

参数名	类型	示例	说明
data	Array	``	返回数据，列表类型
order_id	String	`6917586388057718374`	平台订单ID
verrify_order_ids	String	`123123123123;789789789789`	三方商家的订单Id，如果有多个，使用;分割
cert_id	String	`71937153151279783203`	卡券ID
out_cert_id	String	`123`	外部卡券ID
cert_no	String	`71936748123123166654548`	卡号券码
valid_start	Integer	`1673452800`	有效开始时间
valid_end	Integer	`1674921599`	有效结束时间
grant_time	Integer	`1674914207`	发券时间，0则用当前时间
status	Integer	`1`	状态：1-未激活（表示初始状态）, 2-未使用，3-已使用，4-已废弃，5-已过期，6-已完成
total_num	Integer	`2`	可核销次数
verify_num	Integer	`1`	已核销次数
available_num	Integer	`1`	剩余可用次数

返回示例

{
    "code": "10000",
    "message": "成功",
    "data": [{
        "order_id": "6917586388057718374",
        "verrify_order_ids": "123123123123;789789789789",
        "cert_id": "71937153151279783203",
        "out_cert_id": "123",
        "cert_no": "71936748123123166654548",
        "valid_start": 1673452800,
        "valid_end": 1674921599,
        "grant_time": 1674914207,
        "status": 1,
        "total_num": 2,
        "verify_num": 1,
        "available_num": 1
    }]
}

签名原串示例

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

XXXXXXXXXXXXXXXXXXXXcert_no卡券idcert_type0methodcoupons.listorder_id123timestamp1780000000uid111111111XXXXXXXXXXXXXXXXXXXX

参数名排序：cert_no、cert_type、method、order_id、timestamp、uid

sign = md5(签名原串)（32 位小写）= 7cf0d2b6bc406444baa75215b584c997

请求代码示例

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

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

第 5 / 16 个接口｜导航：返回索引

3.9 KiB Raw Blame History Unescape Escape

券码查询（coupons.list）