Obtén ofertas reservables para un viaje devuelto por la búsqueda.
Autenticación y headers
| Header | Descripción |
|---|---|
Authorization | Bearer <secret_key>. Conserva el secret en el servidor y nunca lo escribas en logs del cliente. |
X-Travelandz-Id | <public_key>:<profile_code>, donde el profile code persistido tiene el formato dp_<12 alfanuméricos>. |
Content-Type | application/json para peticiones con body JSON. |
Petición
Path: gdsprovider actualmente es 0; journeyId viene de la búsqueda. Query opcional: language (en, es, zh) y returnCancellationPolicies (boolean).
Body requerido:
json
{"passengers":[{"type":"adult"},{"type":"senior"}]}Schema de parámetros
gdsproviderCurrently
0journeyIdJourney id returned by the journey search.
Schema de query params
languagereturnCancellationPoliciesSchema del body
passengerspassengers[]typeRespuesta exitosa
Devuelve un objeto journey cuyos itinerarios contienen offers[]. Las ofertas incluyen offerId, partes, flexibilidad, clases, condiciones, políticas de cancelación y precio { amount, currency }.
Schema de respuesta
journeyjourneygdsproviderjourneyjourneyIdjourneyitineraryjourneyitinerary[]itineraryIndexjourneyitinerary[]segmentsjourneyitinerary[]segments[]segmentIdjourneyitinerary[]segments[]departurejourneyitinerary[]segments[]departuredepartureAtjourneyitinerary[]segments[]departurenamejourneyitinerary[]segments[]departurelocationIdjourneyitinerary[]segments[]departurecountryjourneyitinerary[]segments[]departurecountryCodejourneyitinerary[]segments[]arrivaljourneyitinerary[]segments[]arrivalarrivalAtjourneyitinerary[]segments[]arrivalnamejourneyitinerary[]segments[]arrivallocationIdjourneyitinerary[]segments[]arrivalcountryjourneyitinerary[]segments[]arrivalcountryCodejourneyitinerary[]segments[]identifierjourneyitinerary[]segments[]transportjourneyitinerary[]segments[]durationInMinutesjourneyitinerary[]segments[]operatorjourneyitinerary[]segments[]operatorcodejourneyitinerary[]segments[]operatornamejourneyitinerary[]segments[]operatorimageUrljourneyitinerary[]segments[]servicejourneyitinerary[]segments[]servicenamejourneyitinerary[]segments[]serviceimageUrljourneyitinerary[]offersjourneyitinerary[]offers[]offerIdjourneyitinerary[]offers[]partsjourneyitinerary[]offers[]parts[]segmentsjourneyitinerary[]offers[]parts[]segments[]segmentIdjourneyitinerary[]offers[]parts[]segments[]amenitiesjourneyitinerary[]offers[]parts[]segments[]amenities[]journeyitinerary[]offers[]parts[]flexibilityjourneyitinerary[]offers[]parts[]comfortClassjourneyitinerary[]offers[]parts[]serviceClassjourneyitinerary[]offers[]parts[]conditionsjourneyitinerary[]offers[]parts[]conditions[]typejourneyitinerary[]offers[]parts[]conditions[]conditionjourneyitinerary[]offers[]parts[]conditions[]notejourneyitinerary[]offers[]parts[]conditions[]conditionKeyjourneyitinerary[]offers[]parts[]cancellationPoliciesjourneyitinerary[]offers[]parts[]cancellationPolicies[]__typenamejourneyitinerary[]offers[]parts[]cancellationPolicies[]__typenametypejourneyitinerary[]offers[]parts[]cancellationPolicies[]descriptionjourneyitinerary[]offers[]parts[]cancellationPolicies[]minimum_minutes_before_departurejourneyitinerary[]offers[]parts[]cancellationPolicies[]maximum_minutes_before_departurejourneyitinerary[]offers[]parts[]cancellationPolicies[]minimum_minutes_after_departurejourneyitinerary[]offers[]parts[]cancellationPolicies[]maximum_minutes_after_departurejourneyitinerary[]offers[]parts[]cancellationPolicies[]percentageWhen
__typename is CancellationByPercentagejourneyitinerary[]offers[]parts[]cancellationPolicies[]chargePercentageWhen
__typename is CancellationByPercentChargejourneyitinerary[]offers[]parts[]cancellationPolicies[]chargeAmountWhen
__typename is CancellationByFixedChargejourneyitinerary[]offers[]parts[]cancellationPolicies[]currencyWhen
__typename is CancellationByFixedChargejourneyitinerary[]offers[]parts[]cancellationPolicies[]perPersonWhen
__typename is CancellationByPercentCharge or CancellationByFixedCharge. Is optionaljourneyitinerary[]offers[]parts[]cancellationPolicies[]perLegWhen
__typename is CancellationByPercentCharge or CancellationByFixedCharge. Is optionaljourneyitinerary[]offers[]parts[]isRefundablejourneyitinerary[]offers[]pricejourneyitinerary[]offers[]priceamountjourneyitinerary[]offers[]pricecurrencyjourneyitinerary[]offers[]createdAtjourneyitinerary[]offers[]expiresAtjourneystopoversjourneystopovers[]stopoverIndexjourneystopovers[]durationInMinutesjourneyroutejourneyroute[]itineraryIndexjourneyroute[]stopoverIndexjourneycomfortClassesjourneycomfortClasses[]journeyaccommodationsjourneyaccommodations[]journeyticketClassesjourneyticketClasses[]comfortClassjourneyticketClasses[]serviceClassErrores
400por validación o campos desconocidos.401o403por credenciales API inválidas.500 internal_communication_errorounknown_errorpor fallos del proveedor.- 无法找到报价时返回
404 zero_journeys_found。
Notas de uso
Usa cada offerId en el endpoint de pre-reserva. Las ofertas expiran; continúa el flujo antes de expiresAt.
Ejemplo cURL
bash
curl --request POST \
--url "https://api.sandbox.travelandz.com/v1/trains/journeys/0/journey_123/offers?language=en&returnCancellationPolicies=true" \
--header "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
--header "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE" \
--header "Content-Type: application/json" \
--data '{"passengers":[{"type":"adult"}]}'