新增 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 的分析类文档暂不入库,仅保留本地。
4.9 KiB
4.9 KiB
售后审核(afterSale.operate)
本页数据抓取自抖音码速达开放平台「接口API → 售后审核」。
| 项目 | 内容 |
|---|---|
| 接口名称 | 售后审核 |
| 方法名 method | afterSale.operate |
| 功能分级 | 高级功能 |
| 请求地址 | POST https://dy-openplatform-api.wanmahui.com/api/openplatform/gateway |
| Content-Type | application/x-www-form-urlencoded |
| 说明 | 售后统一操作接口 |
| 抖店原始路径 | /afterSale/operate |
| 抖店原始文档 | 售后审核接口聚合版 |
请求参数
| 参数名 | 类型 | 必填 | 提交方式 | 说明 |
|---|---|---|---|---|
| uid | String | 是 | Post | 抖店商户号(公共参数,示例 111111111) |
| method | String | 是 | Post | 方法名,固定为 afterSale.operate(公共参数) |
| timestamp | String | 是 | Post | 秒级时间戳,10 分钟内有效(公共参数) |
| sign | String | 是 | Post | 签名,签名原串 MD5(小写),见「接口调用规范与签名」 |
| type | Integer | 是 | Post | 操作类型:201-同意仅退款,202-拒绝仅退款,示例:201 |
| items | Json | 是 | Post | 操作售后详情,数组类型,以Json字符串形式传入,示例:[{"repair_type":1,"aftersale_id":6959800000297566494,"reason":"卡密商品已发货,不支持退款","remark":"卡密已查看,且可正常使用,拒绝退款","evidence":[{"type":1,"url":"http://xxxxxxxx.jpg","desc":"店铺相关说明"}],"reject_reason_code":1,"update_time":0}] |
| store_id | Integer | 否 | Post | 门店ID,抖超小时达业务使用,示例:123 |
嵌套参数 items
操作售后详情,数组类型,以Json字符串形式传入
提交时以 JSON 字符串整体作为一个参数值,示例:
[{"repair_type":1,"aftersale_id":6959800000297566494,"reason":"卡密商品已发货,不支持退款","remark":"卡密已查看,且可正常使用,拒绝退款","evidence":[{"type":1,"url":"http://xxxxxxxx.jpg","desc":"店铺相关说明"}],"reject_reason_code":1,"update_time":0}]
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| repair_type | Integer | 否 | 维修类型:1-原商品维修,2-商品换新 |
| aftersale_id | Integer | 是 | 售后单号 |
| reason | String | 否 | 操作原因,拒绝操作必填 |
| remark | String | 否 | 操作评论,拒绝操作必填 |
| evidence | Array | 否 | 操作凭证编码,当【查询商家拒绝原因列表】接口响应参数evidence_need=Y时,该参数必填;使用【查询商家拒绝原因列表】接口获取响应参数中的reject_reason_code字段。 |
| type | Integer | 否 | 凭证类型:1-图片 |
| url | String | 否 | 凭证url |
| desc | String | 否 | 凭证描述 |
| reject_reason_code | Integer | 否 | 售后拒绝原因码,拒绝时必填填。通过【查询商家拒绝原因列表】接口获取 |
| update_time | Integer | 否 | 用于校验售后单版本是不是最新的版本,防止售后单变更且open侧审核通过导致资损。使用【买家发起售后】消息推送中的update_time字段 |
返回参数
| 参数名 | 类型 | 示例 | 说明 |
|---|---|---|---|
| data | Array | `` | 审核结果 |
| aftersale_id | Integer | 6959800000297566494 |
售后单号 |
| status_code | Integer | 0 |
操作结果码 |
| status_msg | String | success |
操作结果描述 |
返回示例
{
"code": "10000",
"message": "成功",
"data": [{
"aftersale_id": 6959800000297566494,
"status_code": 0,
"status_msg": "success"
}]
}
签名原串示例
除 sign 外的全部参数按参数名字典序拼接 参数名+参数值,首尾各加一次用户秘钥(这里用占位秘钥 XXXXXXXXXXXXXXXXXXXX、占位商户号 111111111、时间戳 1780000000):
XXXXXXXXXXXXXXXXXXXXitems[{"repair_type":1,"aftersale_id":6959800000297566494,"reason":"卡密商品已发货,不支持退款","remark":"卡密已查看,且可正常使用,拒绝退款","evidence":[{"type":1,"url":"http://xxxxxxxx.jpg","desc":"店铺相关说明"}],"reject_reason_code":1,"update_time":0}]methodafterSale.operatestore_id123timestamp1780000000type201uid111111111XXXXXXXXXXXXXXXXXXXX
参数名排序:items、method、store_id、timestamp、type、uid
sign = md5(签名原串)(32 位小写)= 2be721539a1d74b950eca4e6237c6d50
请求代码示例
页面内置 JAVA / .NET / PHP 三种示例代码,已原样保存:
data/代码示例/接口API-请求示例-JAVA.txtdata/代码示例/接口API-请求示例-DOTNET.txtdata/代码示例/接口API-请求示例-PHP.txt
第 8 / 16 个接口 | 导航: 返回索引