商品状态变更通知
收藏用于商品状态变更后的消息通知
使用限制
开发者应用须开通餐饮商品发布能力，以及完成商家授权
接口说明
1、消息可能重复推送，请使用 Msg_Id 进行去重处理！
3、面向餐饮行业的商品类型（团购、代金券、次卡），发送商品状态变更
基本信息
HTTP URL | 地址由服务商提供 | |||
HTTP Method | POST | |||
申请权限 | 商品发布 | |||
权限要求 | ||||
签名规则
用户可通过请求 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 进行消息去重处理。
