酒店静态信息处理结果推送（webhook）

我的收藏

基本信息

酒店静态信息匹配成功后通知服务商。

基本信息

基本信息
HTTP URL	--
HTTP Method	POST
Scope	xxx.xxxxx
回调地址配置	配置webhook地址， event为 life_hotel_audit_result

请求头

名称	类型	必填	描述
Msg-Id	string	是	同一实体下同一action的msg_id相同，服务商可根据msg_id对于消息去重
X-Douyin-Signature	string	是	抖音侧签名，服务商可根据签名判断该消息是否来自抖音开放平台，抖音服务端会将应用的(client secret + 消息体)使用 sha1 哈希作为 X-Douyin-Signature header 的 value。您可以自行使用 client secret 和收到的消息体进行 sha1 哈希，与该请求头进行比对可参考：文档 - 抖音开放平台 - 服务商平台
Content-Type	string	是	固定值application/json

请求参数

名称	类型	是否必填	描述	示例值
event	string	是	消息类型，用于区分各类消息，酒店静态信息匹配成功的event为life_hotel_audit_result	"life_hotel_audit_result"
client_key	string	是	对应服务商平台或开发者平台中的APPID，应用ID
content	string	是	消息内容，根据需要解析消息内容，不同类型的消息内容不同
log_id	string	是	抖音内部日志id，可提供给抖音方便排查问题

Content内容

参数名称	参数类型	必须参数	备注
» out_hotel_id	string	必填	合作方酒店ID
» hotel_id	string	选填	抖音侧酒店ID •当匹配上且抖音侧酒店可用时返回
» status	enum	必填	匹配状态(结构见公共结构2.2.1)
» message	string	必填	状态说明文案

请求示例

{
    "event":"life_hotel_audit_result",
    "client_key":"xxx",
    "content":"{\"out_hotel_id\":\"abc\",\"hotel_id\":\"1234\",\"status\":6,\"message\":\"酒店信息正常使用\",\"category_id\":8001001}",
    "log_id":"202402281330048D6B1617BAA9BA09514C"
}

响应参数

响应内容可以为空。

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

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

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