POST/v1/hotels/check/:gdsprovider

重新校验酒店报价

在预订前重新校验所选酒店房型报价，以确认可订性、价格变化和预订资格。

分享

在预订前重新校验所选酒店房型报价，以确认可订性、价格变化和预订资格。

接口

方法路径认证
POST/v1/hotels/check/:gdsprovider需要 API key
必需请求头：
Header说明
AuthorizationBearer <secret_key>. The secret is shown only once when the credential is created.
X-Travelandz-Id<public_key>:<profile_code>. The profile_code is the dp_-prefixed Developer Profile code shown in your dashboard. This binds the request to a profile and credential.
Content-TypeUse application/json for requests with a body.

请求参数结构

gdsprovider
number是

请求体

Send the provider offer/rate payload returned by hotel offers.

请求体结构

offers
array是
offers[]gdsprovider
number是
offers[]hotelCode
string是
offers[]rateKey
string是
offers[]adults
number是
offers[]children
number是
offers[]name
string是
offers[]board
string是
offers[]totalPrice
number是
offers[]originalPrice
number否
offers[]currency
enum
EURUSDCNY
是
offers[]originalCurrency
enum
EURUSDCNY
否
offers[]supplements
array是
offers[]supplements[]description
string是
offers[]supplements[]price
number是
offers[]supplements[]currency
string是
offers[]cancellationPolicies
array是
offers[]cancellationPolicies[]amount
number是
offers[]cancellationPolicies[]fromDate
string
Format: ISO 8601
是
offers[]isRefundable
boolean是
checkIn
string
Format: YYYY-MM-DD
是
checkOut
string
Format: YYYY-MM-DD
是

成功响应

返回 the revalidated rate, price and booking eligibility.

响应体结构

available
boolean是
ratesConditions
array是
ratesConditions[]rateKey
string是
ratesConditions[]conditions
array是
ratesConditions[]conditions[]
string[]是
pricesChanged
array是
pricesChanged[]rateKey
string是
pricesChanged[]newPrice
array是
pricesChanged[]newPrice[]
number[]是
ratesUnavailable
array是
ratesUnavailable[]rateKey
string是
liveMode
boolean是
True when the request is served by the live Travelandz environment. This value comes from Travelandz, not the provider payload.

示例

bash
bash
curl -X POST https://api.sandbox.travelandz.com/v1/hotels/check/:gdsprovider \
  -H "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
  -H "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE" \
  -H "Content-Type: application/json" \
  -d '<request_body_json>'