POST/v1/hotels/offers

获取酒店房型报价

返回所选酒店和入住日期的房型、价格、膳食类型和取消政策。

分享

返回所选酒店和入住日期的房型、价格、膳食类型和取消政策。

接口

方法路径认证
POST/v1/hotels/offers需要 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.

Request Parameters

不需要路径参数或查询参数。

请求体

字段类型必填
languageenum否
gdsprovider1 or 3是
hotelCodestring是
checkInYYYY-MM-DD是
checkOutYYYY-MM-DD是
countryCodestring是
guestNationalitystring否
minRatePricenumber否
maxRatePricenumber否
roomsroom[]是

请求体结构

language
enum
eneszh
否
Default en
gdsprovider
number是
hotelCode
string是
checkIn
string
Format: YYYY-MM-DD
是
checkOut
string
Format: YYYY-MM-DD
是
countryCode
string
Format: 2 digits
是
guestNationality
string
Format: 2 digits
是
minRatePrice
number否
maxRatePrice
number否
rooms
array是
rooms[]adults
number是
Minimum value: 1, Maximum value: 4
rooms[]children
number否
Minimum value: 0, Maximum value: 4
rooms[]childrenAges
array是
rooms[]childrenAges[]
number[]是
currency
enum
EURUSDCNY
否
Default EUR

成功响应

返回 hotel rooms, rates, cancellation policies and provider offer identifiers.

响应体结构

offers
array是
offers[]roomNames
array是
offers[]roomNames[]
string[]是
offers[]minPrice
number是
offers[]rates
array是
offers[]rates[]gdsprovider
number是
offers[]rates[]hotelCode
string是
offers[]rates[]rateKey
string是
offers[]rates[]adults
number是
offers[]rates[]children
number是
offers[]rates[]name
string是
offers[]rates[]nameKey
string是
offers[]rates[]board
string是
offers[]rates[]boardKey
string是
offers[]rates[]totalPrice
number是
offers[]rates[]netPrice
number是
offers[]rates[]originalPrice
number是
offers[]rates[]currency
enum
EURUSDCNY
是
offers[]rates[]originalCurrency
enum
EURUSDCNY
是
offers[]rates[]supplements
array是
offers[]rates[]supplements[]description
string是
offers[]rates[]supplements[]price
number是
offers[]rates[]supplements[]currency
string是
offers[]rates[]cancellationPolicies
array是
offers[]rates[]cancellationPolicies[]amount
number是
offers[]rates[]cancellationPolicies[]fromDate
string
Format: ISO 8601
是
offers[]rates[]isRefundable
boolean是
offers[]rates[]numberOfRooms
number是
offers[]rates[]adultsPerRoom
array是
offers[]rates[]adultsPerRoom[]
number[]是
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/offers \
  -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>'