post
https://api.myhostex.com/v3/channel_accounts/booking/promotions/excluded_dates
为某个 Booking.com 优惠活动添加或移除排除的入住日期。只改动你传入的日期:其他排除日期、折扣、关联的房型和价格计划以及房态都不受影响。该接口为同步调用。Booking.com 接受更新后可能要过几十秒才能读到:响应中 confirmed: true 表示已从 Booking.com 读回新日期;confirmed 为 false 表示 Booking.com 已接受但尚未可见,请过一分钟左右再调 GET /channel_accounts/booking/promotions 核对。更新后的几十秒内,GET 可能仍返回旧的排除日期;add 与 remove 是幂等的,重发同样的请求是安全的。删除某个优惠的最后一个排除日期时,也可能返回 confirmed: false。
add与remove是幂等的:添加已排除的日期、移除未排除的日期都不会产生变化。502表示 Booking.com 暂时不可用或结果无法确认,更新仍可能在之后几分钟内生效。重发相同的add与remove是安全的;如要对该优惠传不同的日期,请等几分钟,先用GET /channel_accounts/booking/promotions读取后再决定。- 只能修改已启用的优惠活动(否则返回
409):Booking.com 每次更新成功都会把优惠设为启用,修改已停用的优惠会让它重新上线。 - 日期格式为
YYYY-MM-DD,不能早于今天,且在 3 年以内;add与remove合计最多 366 个日期,且不能包含相同日期。超出 Booking.com 支持范围的日期可能被拒绝,部分优惠类型不支持排除日期(返回400,error_msg中带有 Booking.com 错误码)。 - 每个 Booking.com 住宿每分钟最多更新 10 次,此外仍受账号级限流约束;
429响应带有Retry-After。 - 该功能未对你的账号开放时返回
501。建议先在一个可以随意修改的优惠上验证。
需要可写的访问令牌。
