抖音开放平台Logo
控制台

餐饮团购-商品审核结果通知

更新时间 2024-07-24 02:58:49
收藏
我的收藏
用于餐饮团购商品审核流程结束以后向商家通知审核结果​

使用限制

无​

接口说明

1、消息可能重复推送,请使用 Msg_Id 进行去重处理!​
2、信息推送使用说明参考:生活服务消息推送

基本信息

HTTP URL​
地址由服务商提供​
HTTP Method​
POST​
申请权限​
商品发布​
权限要求​
生活服务商家应用,需要url配置,路径:配置方式
小程序应用自行配置,路径:小程序配置商品审核回调地址

签名规则

用户可通过请求 header 中的 X-Douyin-Signature 字段判断该消息是否来自抖音开放平台。 抖音服务端会将应用的(client secret + 消息体)使用 sha1 哈希作为 X-Douyin-Signature header 的 value。您可以自行使用 client secret 和收到的消息体进行 sha1 哈希,与该请求头进行比对。​

请求头字段

字段
说明
Msg-Id​
同一实体下同一action的msg_id相同,服务商可根据msg_id对于消息去重​
X-Douyin-Signature​
抖音侧签名,服务商可根据签名判断该消息是否来自抖音开放平台​
Content-Type​
固定值application/json​

请求体字段

字段
类型
说明
event​
string​
消息类型,用于区分各类消息,商品审核的event为life_akte_product_audit
client_key​
string​
对应服务商平台或开发者平台中的APPID,应用ID​
content​
string​
消息内容,根据需要解析消息内容,不同类型的消息内容不同​
log_id​
string​
抖音内部日志id,可提供给抖音方便排查问题​

请求参数

Content 内容

字段
类型
说明
product_id​
string​
商品id​
out_id​
string​
商品外部id​
status​
string​
审核状态,枚举如下​
PASS - 审核通过​
FAIL - 审核失败​
reason​
string​
审核失败原因​

请求示例

JSON
复制
{
"event": "life_akte_product_audit",
"client_key": "axxxxxxxxxxxxx",
"content": "{\"product_id\":\"6993730008241948703\",\"out_id\":\"外部id\",\"reason\":\"\",\"status\":\"PASS\"}",
"log_id": "202210101930530102281180650970B5AF"
}

响应参数

响应内容可以为空。​
开发者收到消息推送后,http code 响应 200 且响应时间小于 3s,抖音侧即认为推送成功。​
若开发者 http 响应 code 非 200 或响应时间超过 3s,抖音侧会间隔 500ms 发起重试,最大重试次数为 3 次。​
抖音侧收到成功请求时也可能会继续重复推送,请务必使用请求头中 Msg-Id 进行消息去重处理。​