营销规则接口
接口说明
营销规则推送
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/goodlife/v1/trip/promotion/push/ |
| HTTP Method | POST |
| Scope | life.capacity.trip_hotel_promotion_push |
| 权限要求 | 酒店行业日历房解决方案-营销规则推送 |
请求参数
请求头
access-token必填String
示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
固定值"application/json"
Rpc-Transit-Life-AccountString
来客商户根账户ID
Body展开全部子属性
account_id必填String
商户account_id
applicable_date必填Struct
营销适用日期
展开子属性
applicable_resource必填Struct
营销适用资源
展开子属性
is_auto_extension必填Bool
是否自动延期(如果开通自动延期,需要有效期大于30天)
promotion_basic_info必填Struct
营销基础信息
展开子属性
activeBool
活动是否生效,如果非生效,下面所有的售卖房型也失效,默认生效(false时需要传promotion_id)
daily_sale_promotionStruct
天天特价
展开子属性
early_bird_promotionStruct
提前优惠
展开子属性
flash_sale_promotionStruct
限时抢购
展开子属性
hotel_new_customer_promotionStruct
门店新客
展开子属性
night_sale_promotionStruct
今夜甩卖
展开子属性
promotion_idString
营销ID(为空新增,不为空更新)
succession_promotionStruct
连住优惠
展开子属性
unapplicable_dateStruct
营销不适用日期
展开子属性
请求示例
curl --location --request POST 'https://open.douyin.com/goodlife/v1/trip/promotion/push/' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ --data '{"daily_sale_promotion":{"daily_sale_promotion_detail":{"discount_type":1,"discount_value":990}},"promotion_id":"3K4lxCMC4L","active":false,"night_sale_promotion":{"discount_type":1,"night_saleDetail":[{"end_hour":5058089501039330176,"discount_value":990,"start_hour":2970156254135115590}]},"early_bird_promotion":{"discount_type":1,"early_bird_promotion_detail":[{"advance_day":3499355282848647417,"discount_value":990}]},"succession_promotion":{"discount_type":1,"succession_promotion_detail":[{"stay_length":4467267807979384292,"discount_value":990}]},"hotel_new_customer_promotion":{"hotel_new_customer_promotion_detail":{"discount_type":1,"discount_value":990}},"base":{"log_i_d":"RqsFwz3jQJ","caller":"4HNBQolg0V","addr":"WVQV7gQXSz","client":"PsIPfRC89q","traffic_env":{"open":false,"env":"kQf45mfjlE"},"extra":{"yYrH8xlPvM":"b6l0OUsMTf"}},"promotion_basic_info":{"type_name":"JVqXlwdPU0","sub_type_code":"ceYiDFPv3T","sub_type_code_name":"98NqHvKh8k","out_type":"52b60E8q5V","type_code":"G7RB6Aa4p3"},"unapplicable_date":{"unapplicable_date_range":[{"start_days":"RT8a4dXtvm","end_days":"robKZXKIlU"}]},"is_auto_extension":false,"applicable_resource":{"resources":[{"rate_plan_status":1081535812519282255,"rate_plan_id":"P0ZhdRCQ3v"}]},"account_id":"htRbICYewm","applicable_date":{"start_days":"oKZCGRQOZC","end_days":"rDc1spB1SI","days_of_week":[7603505775285915237]},"flash_sale_promotion":{"flash_sale_detail":[{"discount_value":990,"start_hour":371411707699075753,"end_hour":4514844733188390057}],"discount_type":1}}'
响应参数
Body展开全部子属性
extra必填Struct
扩展信息
展开子属性
dataStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "data": { "promotion_id": "fxmqeSluyi", "status": 1, "message_detail": [ { "rate_plan_id": "pv2RfEbYWF", "error_message": "Vw977upHjn" } ], "error_code": 0, "description": "" }, "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "20251222154457AE2E2C94422AAD06DD4A", "now": 1766389500 }, "base_resp": { "extra": { "Xf8VhsXFBi": "gsLQufOC2f" }, "status_message": "mQGo7ivrWa", "status_code": 4455538186831286000 } }
错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 2100001 | 未知错误 | 重试接口,重试3次仍报错联系抖音生活服务技术支持 |
| 200 | 2100004 | 系统繁忙,此时请开发者稍候再试 | 重试接口,重试3次仍报错联系抖音生活服务技术支持 |
| 200 | 2100005 | 参数不合法 | 更换参数 |
| 200 | 2190002 | access_token无效 | 调用接口重新生成access_token |
| 200 | 2190004 | 应用未获得该能力, 请去https://open.douyin.com/申请 | 应用申请接口权限 |
| 200 | 2190008 | access_token过期,请刷新或重新授权 | 规范token刷新机制,检查是否有测试环境在同步刷新token |
| 200 | 2119001 | 参数不合法 | 更换参数 |
| 200 | 2119002 | 系统繁忙,请稍候再试 | 重试 |
| 200 | 2119003 | 请求太过频繁,请稍后再试 | 重试 |
| 200 | 2119005 | 应用未获商家授权 | 联系合作商家在商家后台发起授权,并在服务商后台同意授权 |
| 200 | 3000001 | 根据实际业务错误返回 | 对照接口文档规范参数并重试 |
| 200 | 4000001 | 根据实际业务错误返回 | 补充参数 |
| 200 | 4000002 | 根据实际业务错误返回 | 对照接口文档规范参数并重试 |
| 200 | 5000001 | 根据实际业务错误返回 | 联系抖音处理 |
| 200 | 5000001 | 以实际错误信息为准 | |
| 200 | 5000001 | 服务器打瞌睡了,请稍后再试。 | |
| 200 | 3000001 | 以实际错误信息为准 |
