门店冒领申诉工单状态变更通知webhook

我的收藏

用于提交门店冒领申诉工单状态变更通知

使用限制

无

接口说明

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

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

基本信息

HTTP URL	地址由开发者提供
HTTP Method	POST
权限要求	门店申诉
Scope	life.capacity.poi.appeal
权限申请	生活服务商家应用，需要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_merchant_open_appeal_ticket_notify
client_key	string	对应服务商平台或开发者平台中的APPID，应用ID
content	string	消息内容，根据需要解析消息内容，不同类型的消息内容不同
log_id	string	抖音内部日志id，可提供给抖音方便排查问题

请求参数

Content 内容

字段	类型	描述
poi_id	int64	抖音门店 ID
appeal_ticket_id	string	申诉工单 ID

请求示例

{
    "content":"{\"poi_id\":7270072041045248044,\"appeal_ticket_id\":\"PR011705047848170KLNFBOE\"}",
    "log_id":"02170504809488700000000000000000000ffff0ac72265264014",
    "event":"life_merchant_open_appeal_ticket_notify",
    "client_key":"awcvczhdn7etx7hc"
}

响应参数

响应内容可以为空。

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

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

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