创建/更新预售券
接口说明
保存或更新预售券信息
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/goodlife/v1/trip/hotel/savepresale/ |
| HTTP Method | POST |
| Scope | life.capacity.trip_presale_push |
| 权限要求 | 酒店新预售券解决方案-住宿预售券创建和更新 |
请求 参数
请求头
access-token必填String
示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
固定值"application/json"
Rpc-Transit-Life-AccountString
来客商户根账户ID
Body展开全部子属性
account_id必填String
商家账户id
需要传总户id,否则会导致匹配失败
presale_info必填Struct
预售详细信息
展开子属性
abilityStruct
商品保存能力开关
展开子属性
请求示例
{ "account_id": "1234567890", "presale_info": { "category_id": "101", "pre_sale_coupon_info": { "coupon_name": "酒店双人预售券", "apply_room_number": 1, "apply_nights": 1, "bind_rate_plans": [ "9876543210" ], "imange_list": [ { "image_type": 1, "image_url": "https://example.com/images/presale-head.jpg" }, { "image_type": 2, "image_url": "https://example.com/images/presale-detail.jpg" } ], "original_amount": 10000, "actual_amount": 8000, "sales_type": 1, "coupon_separate": false }, "sale_info": { "show_channel": 1, "inventory_info": { "is_limit": true, "num": 100 }, "sale_date": { "from": "2026-06-01 00:00", "to": "2026-06-30 23:59" }, "book_date": { "from": "2026-06-01", "to": "2026-12-31" }, "is_auto_extension": false }, "trade_info": { "customer_can_use_date": { "use_date_type": 1, "use_date": { "from": "2026-06-01", "to": "2026-12-31" } }, "customer_can_use_time": { "use_time_type": 1 }, "limt_buy_rule": { "each_person_each_order_max": 1 }, "book_rule": { "earliest_book_day": 30 }, "cancel_booking_rule": { "cancel_type": 3 }, "invoic_info": { "provider": 1 } }, "note_info": { "check_time_range": { "from": "14:00", "to": "12:00" }, "other_remark_info": [ "需提前预约,以门店确认为准" ], "service_for_foreign": false, "superimposed_discounts": false }, "out_id": "isv-presale-20260601-001", "currency": "CNY" }, "ability": { "ignore_inapplicable_poi": false } }
响应参数
Body展开全部子属性
extra必填Struct
扩展信息
展开子属性
dataStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "data": { "pre_sale_coupon_id": "NSRP3Wjuwn", "out_id": "UGnXfxJ581", "error_code": 0, "description": "" }, "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "202605072017223DC6BE80DCD0E1D05DEF", "now": 1778156245 }, "base_resp": { "status_code": 109603077904630500, "extra": { "hpOI1t6yaU": "EFRouhXntA" }, "status_message": "IjeYLRdk47" } }
错误码
| 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 | 2119010 | 接口已下线 | 接口已下线 |
| 200 | 3000001 | 以实际错误信息为准 | |
| 200 | 5000001 | 服务器打瞌睡了,请稍后再试。 |
