post
https://api.myhostex.com/v3/channel_accounts/booking/promotions
在某个 Booking.com 住宿上新建优惠活动。优惠一建成就会在 Booking.com 上生效,发送前请核对折扣、日期、房型和价格计划。必填字段与允许的取值取决于 type(见下方各字段);明显无效的请求百居易会在调用 Booking.com 之前直接返回 400。
- 必须带
idempotency_key。Booking.com 每收到一次请求就新建一条优惠,所以失败或超时后请用同一个 key 重发:百居易会返回第一次请求建出的那条优惠(created: false),而不是再建一条。这一保护从第一次请求起保持 24 小时。在用GET /channel_accounts/booking/promotions核对之前,不要换新 key 重试。502的错误信息里列出了优惠 id 时,其中可能就有本次请求建出的那条:请核对这些优惠,不要再重试。 - 请使用 JSON 请求体。
- Booking.com 每个住宿只有一条
mobile_rate优惠,每个国家渠道(target_channel)只有一条geo_rate优惠,id 固定(MR、GR<target_channel>)。已存在(无论启用与否)时再新建会覆盖那一条,所以百居易会先读取住宿的优惠,已存在时返回409并给出现有 id:请改用PATCH /channel_accounts/booking/promotions/{promotion_id}修改那条优惠。如果你是在重试一个可能已经成功的新建,409里的 id 就是它建出的优惠。 non_refundable: true时,如果住宿还没有不可退款政策,Booking.com 会自动新建一个 3 天不可退款政策。- Booking.com 优惠无法删除;要去掉一条优惠,请用
POST /channel_accounts/booking/promotions/{promotion_id}/deactivate停用。 - 除下面的每分钟限制外,每个 Booking.com 住宿每天(服务器时区)最多 20 次新建请求;
429响应带有Retry-After。 - 你的账号未开放新建与编辑优惠时返回
501(与POST /channel_accounts/booking/promotions/excluded_dates分开开放)。 - 每个 Booking.com 住宿每分钟最多 10 次优惠写入,与
POST /channel_accounts/booking/promotions/excluded_dates共用,此外仍受账号级限流约束;429响应带有Retry-After。 - Booking.com 拒绝的取值返回
400,error_msg中带有 Booking.com 错误码(如DISCOUNT_NOT_IN_RANGE、ROOMS_INVALID、TARGET_CHANNEL_NO_ACCESS)。 502表示 Booking.com 暂时不可用或结果无法确认,改动仍可能在之后几分钟内生效。
需要可写的访问令牌。
