POST/v1/hotels/check/:gdsprovider

Revalidar oferta de hotel

Revalida ofertas de habitación antes de reservar para confirmar disponibilidad, cambios de precio y elegibilidad de booking.

Compartir

Revalida ofertas de habitación antes de reservar para confirmar disponibilidad, cambios de precio y elegibilidad de booking.

Endpoint

MétodoRutaAuth
POST/v1/hotels/check/:gdsproviderAPI 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.

Esquema de parámetros de la petición

gdsprovider
numberSí

Cuerpo de la petición

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

Esquema del cuerpo de la petición

offers
arraySí
offers[]gdsprovider
numberSí
offers[]hotelCode
stringSí
offers[]rateKey
stringSí
offers[]adults
numberSí
offers[]children
numberSí
offers[]name
stringSí
offers[]board
stringSí
offers[]totalPrice
numberSí
offers[]originalPrice
numberNo
offers[]currency
enum
EURUSDCNY
Sí
offers[]originalCurrency
enum
EURUSDCNY
No
offers[]supplements
arraySí
offers[]supplements[]description
stringSí
offers[]supplements[]price
numberSí
offers[]supplements[]currency
stringSí
offers[]cancellationPolicies
arraySí
offers[]cancellationPolicies[]amount
numberSí
offers[]cancellationPolicies[]fromDate
string
Format: ISO 8601
Sí
offers[]isRefundable
booleanSí
checkIn
string
Format: YYYY-MM-DD
Sí
checkOut
string
Format: YYYY-MM-DD
Sí

Respuesta exitosa

Devuelve the revalidated rate, price and booking eligibility.

Esquema del cuerpo de la respuesta

available
booleanSí
ratesConditions
arraySí
ratesConditions[]rateKey
stringSí
ratesConditions[]conditions
arraySí
ratesConditions[]conditions[]
string[]Sí
pricesChanged
arraySí
pricesChanged[]rateKey
stringSí
pricesChanged[]newPrice
arraySí
pricesChanged[]newPrice[]
number[]Sí
ratesUnavailable
arraySí
ratesUnavailable[]rateKey
stringSí
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/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>'