创建/更新预售券
接口说明
保存或更新预售券信息
基本信息
| 名称 | 描述 |
|---|---|
| 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
商品保存能力开关
展开子属性
请求示例
curl --location --request POST 'https://open.douyin.com/goodlife/v1/trip/hotel/savepresale/' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ --data '{"account_id":"rOxg5zDLp4","presale_info":{"currency":"X8nKyXsby9","sale_info":{"show_channel":1,"inventory_info":{"is_limit":false,"num":8235675378236922718},"sale_date":{"to":"Dostpku4d0","from":"UHBspmFxgQ"},"book_date":{"from":"F1XpPUm5Mn","to":"5ZHN5llnbq"},"is_auto_extension":false},"pre_sale_coupon_info":{"appointment_award":{"time_type":1,"date_range":{"end":"2hoAOQ2CBo","start":"ukdlKLPYZm"},"after_pay_days":7712652116218401507,"is_award":false,"award_type":1,"content":"aAgcCWKbTo","is_award_display":false},"actual_amount":4789905274940194418,"is_test_data":false,"coupon_separate":false,"original_amount":8039872979673247350,"sales_type":1,"commodity":[{"group_name":"4OMDUztOVU","total_count":5170942868851709853,"optional_count":7564219756731618186,"item_info":[{"product_info":{"name":"FOijCgYTrr","price":6329069616724122979,"count":5256555820553920334,"unit":"Sny0W1rEmk","image_url":"Dn5fQljQQ7"}}],"effect_scope":[{"effect_id_list":["v12S2orliO"],"effect_type":1}],"commodity_type":1}],"markup_info":[{"markup_holidays":[1],"markup_effect_scope":[{"effect_type":1,"effect_id_list":["kse4utJwEV"],"is_full_effect":false}],"markup_days":{"to":"ouu3ugjmyJ","from":"NPNNVl24kb"},"markup_days_of_week":[1],"markup_date_type":1,"markup_amount":212995782851766558,"holidays_year":{"1":"clAlBpBK4N"},"markup_time":[{"markup_days":{"from":"qbgXAKKmHc","to":"f5qvxKa1ok"},"holidays_year":{"1":"b7V80krqY9"},"markup_date_type":1,"markup_days_of_week":[1],"markup_holidays":[1]}]}],"apply_to_order":false,"markup_type":2883814982141711950,"usage_duration":4587880888803004761,"bind_rate_plans":["3nEhyNpVAe"],"apply_room_number":4985633602715141252,"coupon_name":"6l7uwyyPtQ","hotel_customer_reserved_info":{"by_merchant_custom_config":false,"require_booking_info":{"enable":false,"identity_type_with_content_list":[{"need_consistency_purchase_and_booking":{"1":false},"contact_identity_type_enum":1,"contact_identity_content_list":[1]}]},"require_purchase_contact_info":{"enable":false,"identity_type_with_content_list":[{"need_consistency_purchase_and_booking":{"1":false},"contact_identity_type_enum":1,"contact_identity_content_list":[1]}]}},"apply_nights":3300886557389582703,"imange_list":[{"image_type":1,"image_url":"OQvqfT1ekR"}]},"note_info":{"superimposed_discounts":false,"long_term_charge_policy":[{"max_add_guest_num":2063028300305400907,"is_free":false,"amount":5908039291247518703,"fee_refund_time":5682751832836198479,"standard_guest_num":7742627553456887724,"frequency":716597700896265376,"is_provided":false,"unit":1,"item_type":1}],"exclusive_fee":[{"unit":"CepdU6px0Z","image_url":"3e7Qlmxt8X","name":"KD4NfOIpIv","price":6127538769033069390,"count":20752823616778349}],"check_time_range":{"to":"vl1O8brOiK","from":"0Ty302ldnY"},"other_remark_info":["GhSrAKPHn6"],"service_for_foreign":false},"out_id":"Uel2TOoRgl","category_id":"2aBNE9NvQB","trade_info":{"cancel_booking_rule":{"cancel_type":1,"cancel_time_type":1,"cancel_offset":[{"time_offset":{"second":4326817578174015461,"day":3841823203583873260,"hour":5947027321379702785,"minute":5781764678268950899},"cut_type":1,"cut_value":3777496523151391955}]},"limt_buy_rule":{"each_person_each_order_max":4588089960814559713,"each_person_max":8958162403911620147,"each_order_can_use_max":6616037265982854472},"customer_can_use_time":{"use_time_type":1,"use_time_list":[{"is_time_nextday":false,"time_span":{"from":"NnI3iPp7Ze","to":"5NSRSl8OT6"}}]},"partly_reserve_refund_rule":1,"partly_reserve_refund_percent":5946753865730509933,"invoic_info":{"provider":1,"invoice_types":[1],"subject":"6qXMujIesU"},"book_rule":{"time_unit":1,"time_pre_book":8888759677627536830,"earliest_book_day":3610093363714687623},"customer_can_use_date":{"use_date":{"from":"bcvpe26Mlw","to":"uApB9MkD71"},"use_date_type":1,"day_duration":1570835921640993076},"cancel_booking_rule_list":[{"cancel_type":1,"cancel_time_type":1,"cancel_offset":[{"cut_value":1935638996056846615,"time_offset":{"day":3683654410704874663,"hour":2809047515870578017,"minute":597173067259460558,"second":6794200311825928777},"cut_type":1}]}],"customer_can_no_use_date":{"holidays_year":{"1":"qvSSCtTFH4"},"cannot_use_days_of_week":[1],"cannot_use_holidays":[1],"cannot_use_date":["m9vh4N57Dm"]}},"settle_type":1,"member_required":4857923399172500033,"pre_sale_coupon_id":"yEvrywtl4f","meals":[{"type":1,"num":3128609469812853807}]},"ability":{"ignore_inapplicable_poi":false},"base":{"addr":"LVm8hKuyNp","client":"o8xP0udfbN","traffic_env":{"open":false,"env":"SGcMavN7H7"},"extra":{"wkjYWz2e0x":"nrt5xulmMG"},"log_i_d":"rqWwzsPzwp","caller":"OObBFWenqP"}}'
响应参数
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 | 5000001 | 服务器打瞌睡了,请稍后再试。 | |
| 200 | 3000001 | 以实际错误信息为准 |
