yml2213
5978e92370
新增 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 的分析类文档暂不入库，仅保留本地。
3.9 KiB
3.9 KiB
卖家发货（trade_TradeSellerShip）
本页数据抓取自抖音码速达开放平台「消息推送 → 卖家发货」。
| 项目 | 内容 |
|---|---|
| 消息名称 | 卖家发货 |
| 消息主题 topic | trade_TradeSellerShip |
| 功能分级 | 基础功能 |
| 说明 | 卖家对所有商品发货完成，且父订单状态为【已发货】时，会推送此消息 |
| 抖店原始文档 | 卖家发货消息 |
| 抖店消息 tag | 102 |
推送参数
| 参数名 | 类型 | 提交方式 | 说明 |
|---|---|---|---|
| topic | String | Get | 消息主题：trade_TradeSellerShip |
| pub_time | Number | Get | 原消息发布时间（秒时间戳） |
| data | String | Post | 消息内容，JSON 字符串（URL 编码后提交） |
| sign | String | Get | 签名，签名原串 MD5（小写），见「消息推送规范与签名」 |
data 内容（属性说明）
| 属性名 | 类型 | 示例 | 说明 |
|---|---|---|---|
| receiver_msg | Object | `` | 收货人详细信息 |
| addr | String | {} |
收货地址，包含省市区和详细地址 |
| name | String | 张三 |
收货人姓名 |
| tel | String | 13117428564 |
收货人手机号 |
| p_id | Integer | 4835999782215623000 |
父订单ID |
| s_ids | Array | [ 123 ] |
子订单ID列表 |
| shop_id | Integer | 597277 |
店铺ID，即时零售店铺该字段为即时零售总部id |
| biz | Integer | 2 |
订单业务类型，表示买家从哪里看到的这个商品、产生了订单：1-鲁班广告，2-联盟，4-商城，8-自主经营，10-线索通支付表单，12-抖音门店，14-抖+，15-穿山甲 |
| logistics_msg | Object | `` | 发货物流信息 |
| express_company_id | String | yunda |
发货快递公司 |
| logistics_code | String | 431******408 |
发货物流单号 |
| order_status | Integer | 3 |
父订单状态，卖家发货消息的status值为"3" |
| order_type | Integer | 2 |
订单类型： 0: 实物 2: 普通虚拟 4: poi核销 5: 三方核销 6: 服务市场 |
| update_time | Integer | 1630335741 |
订单发货时间 |
| store_id | Integer | 597277 |
即时零售门店ID |
data 内容示例（JSON）
{
"receiver_msg": {
"addr": "{}",
"name": "张三",
"tel": "13117428564"
},
"p_id": 4835999782215623000,
"s_ids": [
123
],
"shop_id": 597277,
"biz": 2,
"logistics_msg": {
"express_company_id": "yunda",
"logistics_code": "431******408"
},
"order_status": 3,
"order_type": 2,
"update_time": 1630335741,
"store_id": 597277
}
签名原串示例
推送参数 data、pub_time、topic 按参数名字典序拼接 参数名+参数值，首尾各加一次用户秘钥（占位秘钥 XXXXXXXXXXXXXXXXXXXX、时间戳 1780000000）：
XXXXXXXXXXXXXXXXXXXXdata{"receiver_msg":{"addr":"{}","name":"张三","tel":"13117428564"},"p_id":4835999782215623000,"s_ids":[123],"shop_id":597277,"biz":2,"logistics_msg":{"express_company_id":"yunda","logistics_code":"431******408"},"order_status":3,"order_type":2,"update_time":1630335741,"store_id":597277}pub_time1780000000topictrade_TradeSellerShipXXXXXXXXXXXXXXXXXXXX
sign = md5(签名原串)（32 位小写）= 83208e09a486476a7adc5d8db83ff01b
推送/测试地址
- 平台消息推送测试入口：
GET https://dy-openplatform-api.wanmahui.com/api/openplatform/messagetest?topic=trade_TradeSellerShip&pub_time={秒时间戳}&sign={签名}（data 以 POST body 提交） - 正式接收地址由商家在「接口API → 消息设置」中配置（
message.message_config），平台按topics订阅的主题推送到该地址。
第 3 / 14 条消息 ｜ 导航： 返回索引