预订单状态变更通知
收藏
我的收藏用于门店订座订单状态发生变化后向商家通知
使用限制
无
接口说明
1、消息可能重复推送,请使用 Msg_Id 进行去重处理!
2、信息推送使用说明参考:生活服务消息推送
基本信息
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_hermes_akte_booking_status_notification |
client_key | string | 对应服务商平台或开发者平台中的APPID,应用ID |
content | string | 消息内容,根据需要解析消息内容,不同类型的消息内容不同 |
log_id | string | 抖音内部日志id,可提供给抖音方便排查问题 |
请求参数
参数 | | | 类型 | 含义 |
event | | | string | 事件名,唯一标识,life_hermes_akte_booking_status_notification |
from_user_id | | | string | 未使用 |
to_user_id | | | string | 未使用 |
client_key | | | string | 开发者唯一标识 |
content | | | string | 具体内容,类型:json string |
| account_id | | string | 商家id |
| order_id | | string | 抖音预订单号 |
| status | | i32 | 预订单状态 待接单 10 待到店 11 已拒单 12 已到店 20 未到店 21 已取消 30 |
| change_time | | i64 | 变更时间 |
请求示例
{ "event": "life_hermes_akte_booking_status_notification", "client_key": "axxxxxxxxxxxxx", "content": "{\"account_id\":\"111\",\"order_id\":\"111\",\"status\":1,\"change_time\":1715258222}", "log_id": "202210101930530102281180650970B5AF" }
响应参数
响应内容可以为空。
开发者收到消息推送后,http code 响应 200 且响应时间小于 3s,抖音侧即认为推送成功。
若开发者 http 响应 code 非 200 或响应时间超过 3s,抖音侧会间隔 500ms 发起重试,最大重试次数为 3 次。
抖音侧收到成功请求时也可能会继续重复推送,请务必使用请求头中 Msg-Id 进行消息去重处理。