POST/v1/hotels/offers

Obtener ofertas de habitaciones

Devuelve habitaciones, tarifas, regímenes y políticas de cancelación para un hotel y una estadía seleccionados.

Compartir

Devuelve habitaciones, tarifas, regímenes y políticas de cancelación para un hotel y una estadía seleccionados.

Endpoint

MétodoRutaAuth
POST/v1/hotels/offersAPI key requerida
Headers obligatorios:
HeaderDescripción
AuthorizationBearer <secret_key>. El secret se muestra una sola vez al crear la credencial.
X-Travelandz-Id<public_key>:<profile_code>. El profile_code es el codigo de Developer Profile con prefijo dp_ que ves en el dashboard. Esto vincula la peticion con un perfil y una credencial.
Content-TypeUsa application/json para peticiones con cuerpo.

Parámetros de la petición

No requiere parámetros de ruta ni query.

Cuerpo de la petición

CampoTipoRequerido
languageenumNo
gdsprovider1 or 3Sí
hotelCodestringSí
checkInYYYY-MM-DDSí
checkOutYYYY-MM-DDSí
countryCodestringSí
guestNationalitystringNo
minRatePricenumberNo
maxRatePricenumberNo
roomsroom[]Sí

Esquema del cuerpo de la petición

language
enum
eneszh
No
Default en
gdsprovider
numberSí
hotelCode
stringSí
checkIn
string
Format: YYYY-MM-DD
Sí
checkOut
string
Format: YYYY-MM-DD
Sí
countryCode
string
Format: 2 digits
Sí
guestNationality
string
Format: 2 digits
Sí
minRatePrice
numberNo
maxRatePrice
numberNo
rooms
arraySí
rooms[]adults
numberSí
Minimum value: 1, Maximum value: 4
rooms[]children
numberNo
Minimum value: 0, Maximum value: 4
rooms[]childrenAges
arraySí
rooms[]childrenAges[]
number[]Sí
currency
enum
EURUSDCNY
No
Por defecto EUR

Respuesta exitosa

Devuelve hotel rooms, rates, cancellation policies and provider offer identifiers.

Esquema del cuerpo de la respuesta

offers
arraySí
offers[]roomNames
arraySí
offers[]roomNames[]
string[]Sí
offers[]minPrice
numberSí
offers[]rates
arraySí
offers[]rates[]gdsprovider
numberSí
offers[]rates[]hotelCode
stringSí
offers[]rates[]rateKey
stringSí
offers[]rates[]adults
numberSí
offers[]rates[]children
numberSí
offers[]rates[]name
stringSí
offers[]rates[]nameKey
stringSí
offers[]rates[]board
stringSí
offers[]rates[]boardKey
stringSí
offers[]rates[]totalPrice
numberSí
offers[]rates[]netPrice
numberSí
offers[]rates[]originalPrice
numberSí
offers[]rates[]currency
enum
EURUSDCNY
Sí
offers[]rates[]originalCurrency
enum
EURUSDCNY
Sí
offers[]rates[]supplements
arraySí
offers[]rates[]supplements[]description
stringSí
offers[]rates[]supplements[]price
numberSí
offers[]rates[]supplements[]currency
stringSí
offers[]rates[]cancellationPolicies
arraySí
offers[]rates[]cancellationPolicies[]amount
numberSí
offers[]rates[]cancellationPolicies[]fromDate
string
Format: ISO 8601
Sí
offers[]rates[]isRefundable
booleanSí
offers[]rates[]numberOfRooms
numberSí
offers[]rates[]adultsPerRoom
arraySí
offers[]rates[]adultsPerRoom[]
number[]Sí
liveMode
booleanSí
True cuando la peticion se sirve desde el entorno live de Travelandz. Este valor viene de Travelandz, no del payload del proveedor.

Ejemplo

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>'