抖音服务市场订单事件
概述
Webhooks 说明文档可参考:Webhooks 概述。
webhook 是用户事件触发反向通知的机制,用户需要申请market.service.user这个 scope,抖音服务市场提供的 Webhooks 事件如下。
事件名称 | 事件介绍 |
---|---|
订单事件 | 触发时机:用户订单状态改变 |
使用限制
- 需要在抖音服务市场申请平台应用类服务,且勾选“是否需要订阅webhook消息”,且服务通过审核。
- 服务接入的应用申请market.service.user这个scope。
申请地址:抖音开放平台-控制台-我的应用-权限管理-特殊权限
申请链接:https://developer.open-douyin.com/webapp/应用 client_key/ability/special
- 服务接入的应用订阅服务市场订单事件。
申请地址:抖音开放平台-控制台-我的应用-设置-开发设置
申请链接:https://developer.open-douyin.com/webapp/应用 client_key/setting/develop-info
事件说明
- 事件名称 : "抖音服务市场订单事件"。
- 事件介绍 : 对于抖音服务市场的用户购买“平台应用类服务”的订单,在订单状态改变时,服务市场会通过开放平台Webhooks机制,将事件推送到开发者配置好的回调地址。
- 事件内容定义如下:其中响应参数中的 remain_service_times、effective_time 和 expire_time,根据服务周期的不同返回不同的结果:对于服务周期为“按次服务”和“按条服务”的服务,返回 remain_service_times。对于服务周期为“时间类型”的服务,返回 effective_time 和 expire_time。
事件参数
名称 | 类型 | 描述 | 示例值 | ||
---|---|---|---|---|---|
event | string | 事件名称 | service_market_order | ||
client_key | string | 应用client_key | awa3utacdjjpxxxx | ||
from_user_id | string | 购买用户open_id | c97cdcb3-76a1-433b-92c9-7abc6241xxxx | ||
content | string | 消息内容,json格式 | |||
order_id | string | 订单id | 701913106392234xxxx | ||
order_event | int | 事件类型 | 1:用户支付订单 2:服务商接单 3:服务商确认实施订单 4:用户确认订单 5:取消订单 | ||
order_snapshot | struct | 订单快照信息 | |||
order_id | string | 订单id | 701913106392234xxxx | ||
service_id | string | 服务id,服务的唯一标识 | 7021602203591****** | ||
service_name | string | 服务名称 | 服务名称 | ||
service_mode_id | string | 服务规格id,由服务商在创建服务时指定 | standard_1 | ||
specification_type | int | 服务规格类型 | 1:体验版 2:定制版 3:标准版 | ||
specification_title | string | 服务规格名称 | 标准版 | ||
create_time | int64 | 订单创建时间 | 1631850028000 | ||
order_event_time | int64 | 订单状态改变时间,对应order_event类型 | 1631850028000 | ||
purchase_info | struct | 用户与服务规格订购关系 | |||
order_id | string | 订单id | 701913106392234xxxx | ||
service_id | string | 服务id,服务的唯一标识 | 7021602203591****** | ||
service_mode_id | string | 服务规格id,由服务商在创建服务时指定 | standard_1 | ||
specification_type | int | 服务规格类型 | 1:体验版 2:定制版 3:标准版 | ||
effective_time | int64 | 服务生效毫秒级时间戳 | 1651409686000 | ||
expire_time | int64 | 服务失效毫秒级时间戳 | 1651841686602 | ||
remain_service_times | int64 | 剩余服务次数/条数 | 1 | ||
log_id | string | 日志id | 202209021108180101350232201xxxxxx |
事件参数示例
{ "event": "service_market_order", "client_key": "awa3utacdjjpxxxx", "from_user_id": "c97cdcb3-76a1-433b-92c9-7abc6241xxxx", "content": "{\"order_id\":\"701913106392234xxxx\",\"order_event\":1,\"order_snapshot\":{\"order_id\":\"701913106392234xxxx\",\"service_id\":\"7021602203591******\",\"service_name\":\"服务名称\",\"service_mode_id\":\"standard_1\",\"specification_type\":3,\"specification_title\":\"标准版\",\"create_time\":1631850028000,\"order_event_time\":1631850028000},\"purchase_info\":{\"order_id\":\"701913106392234xxxx\",\"service_id\":\"7021602203591******\",\"service_mode_id\":\"standard_1\",\"specification_type\":3,\"effective_time\":1651409686000,\"expire_time\":1651841686602}}", "log_id": "2022090211081801013502322010023F26" } // content unstringfy后 { "order_id": "701913106392234xxxx", "order_event": 1, "order_snapshot": { "order_id": "701913106392234xxxx", "service_id": "7021602203591******", "service_name": "服务名称", "service_mode_id": "standard_1", "specification_type": 3, "specification_title": "标准版", "create_time": 1631850028000, "order_event_time": 1631850028000 }, "purchase_info": { "order_id": "701913106392234xxxx", "service_id": "7021602203591******", "service_mode_id": "standard_1", "specification_type": 3, "effective_time": 1651409686000, "expire_time": 1651841686602 } }