日历房套餐审核结果推送(Webhook)
收藏
我的收藏接口说明
日历房套餐审核通过/拒绝后通知服务商。
基本信息
基本信息 | ||||
HTTP URL | -- | |||
HTTP Method | POST | |||
Scope | life.capacity.hotel_product_audit | |||
回调地址配置 | 配置webhook地址, event为life_hotel_group_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_physical_room_audit_result | "life_hotel_physical_room_audit_result" |
client_key | string | 是 | 对应服务商平台或开发者平台中的APPID,应用ID | |
content | string | 是 | 消息内容,根据需要解析消息内容,不同类型的消息内容不同 | |
log_id | string | 是 | 抖音内部日志id,可提供给抖音方便排查问题 | |
Content内容
名称 | 类型 | 是否必填 | 描述 | 示例值 |
poi_id | string | 是 | 抖音侧poi_id(等价与上文中的hotel_id) | |
rate_plan_id | string | 是 | 返回抖音侧生成的售卖房型id | |
out_rate_plan_id | string | 是 | 返回对接侧的外部售卖房型id | |
audit_result | enum | 是 | 审核结果状态 | 1: 审核通过,2:审核未通过,3:审核中 |
audit_message | string | 否 | 审核结果通知文案 | "审核通过" |
响应参数
响应内容可以为空。
开发者收到消息推送后,http code 响应 200 且响应时间小于 3s,抖音侧即认为推送成功。
若开发者 http 响应 code 非 200 或响应时间超过 3s,抖音侧会间隔 500ms 发起重试,最大重试次数为 3 次。
抖音侧收到成功请求时也可能会继续重复推送,请务必使用请求头中 Msg-Id 进行消息去重处理。