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.
Devuelve habitaciones, tarifas, regímenes y políticas de cancelación para un hotel y una estadía seleccionados.
Endpoint
| Método | Ruta | Auth |
|---|---|---|
POST | /v1/hotels/offers | API key requerida |
| Header | Descripción |
|---|---|
Authorization | Bearer <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-Type | Use application/json for requests with a body. |
Esquema del cuerpo de la petición
| Propiedad | Tipo | Detalles | Requerido | Notas |
|---|---|---|---|---|
language | enum | eneszh | No | Default en |
gdsprovider | number | Sí | - | |
hotelCode | string | Sí | - | |
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 | number | No | - | |
maxRatePrice | number | No | - | |
rooms | array | Sí | - | |
rooms[]adults | number | Sí | Minimum value: 1, Maximum value: 4 | |
rooms[]children | number | No | Minimum value: 0, Maximum value: 4 | |
rooms[]childrenAges | array | Sí | - | |
rooms[]childrenAges[] | number[] | Sí | - | |
currency | enum | EURUSDCNY | No | Default EUR |
Respuesta exitosa
Devuelve hotel rooms, rates, cancellation policies and provider offer identifiers.
Esquema del cuerpo de la respuesta
| Propiedad | Tipo | Detalles | Requerido | Notas |
|---|---|---|---|---|
offers | array | Sí | - | |
offers[]roomNames | array | Sí | - | |
offers[]roomNames[] | string[] | Sí | - | |
offers[]minPrice | number | Sí | - | |
offers[]rates | array | Sí | - | |
offers[]rates[]gdsprovider | number | Sí | - | |
offers[]rates[]hotelCode | string | Sí | - | |
offers[]rates[]rateKey | string | Sí | - | |
offers[]rates[]adults | number | Sí | - | |
offers[]rates[]children | number | Sí | - | |
offers[]rates[]name | string | Sí | - | |
offers[]rates[]nameKey | string | Sí | - | |
offers[]rates[]board | string | Sí | - | |
offers[]rates[]boardKey | string | Sí | - | |
offers[]rates[]totalPrice | number | Sí | - | |
offers[]rates[]netPrice | number | Sí | - | |
offers[]rates[]originalPrice | number | Sí | - | |
offers[]rates[]currency | enum | EURUSDCNY | Sí | - |
offers[]rates[]originalCurrency | enum | EURUSDCNY | Sí | - |
offers[]rates[]supplements | array | Sí | - | |
offers[]rates[]supplements[]description | string | Sí | - | |
offers[]rates[]supplements[]price | number | Sí | - | |
offers[]rates[]supplements[]currency | string | Sí | - | |
offers[]rates[]cancellationPolicies | array | Sí | - | |
offers[]rates[]cancellationPolicies[]amount | number | Sí | - | |
offers[]rates[]cancellationPolicies[]fromDate | string | Format: ISO 8601 | Sí | - |
offers[]rates[]isRefundable | boolean | Sí | - | |
offers[]rates[]numberOfRooms | number | Sí | - | |
offers[]rates[]adultsPerRoom | array | Sí | - | |
offers[]rates[]adultsPerRoom[] | number[] | Sí | - | |