商品状态变更通知

我的收藏

用于商品状态变更后的消息通知

使用限制

开发者应用须开通餐饮商品发布能力，以及完成商家授权

接口说明

1、消息可能重复推送，请使用 Msg_Id 进行去重处理！

2、信息推送使用说明参考：生活服务消息推送

3、面向餐饮行业的商品类型（团购、代金券、次卡），发送商品状态变更

基本信息

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_product_status_change
client_key	string	对应服务商平台或开发者平台中的APPID，应用ID
content	string	消息内容，根据需要解析消息内容，不同类型的消息内容不同
log_id	string	抖音内部日志id，可提供给抖音方便排查问题

content内容

字段	类型	说明
product_id	string	商品id
out_id	string	外部商品ID，存在时返回
status	string	变更后的商品状态，枚举如下：商品上架：GOODS_ONLINE 商品下架：GOODS_OFFLINE 商品删除：GOODS_DELETE 商品封禁：GOODS_BAN
offline_type	int	当状态变更为下架时返回，下架类型如下： 1 - 发码失败触发下架 2 - 治理巡检下架 3 - 商品售卖过期下线 10 - 默认类型
offline_reason	string	商品下架原因包括： 1、发码失败触发下架 2、治理巡检下架，原因根据治理侧返回 3、商品售卖过期下线

请求示例

{
  "event": "life_product_status_change",
  "client_key": "axxxxxxxxxxxxx",
  "content": "{\"product_id\":\"6993730008241948703\",\"out_id\":\"xxx_out_id\",\"status\":\"GOODS_OFFLINE\"}",
  "log_id": "202210101930530102281180650970B5AF"
}

响应参数

响应内容可以为空。

开发者收到消息推送后，http code 响应 200 且响应时间小于 3s，抖音侧即认为推送成功。

若开发者 http 响应 code 非 200 或响应时间超过 3s，抖音侧会间隔 500ms 发起重试，最大重试次数为 3 次。

抖音侧收到成功请求时也可能会继续重复推送，请务必使用请求头中 Msg-Id 进行消息去重处理。