POST/v1/trains/book/:gdsprovider/prebook

Crear una pre-reserva de tren

Crea una reserva temporal a partir de una o más ofertas de tren seleccionadas.

Compartir

Crea una reserva temporal a partir de una o más ofertas de tren seleccionadas.

Autenticación y headers

HeaderDescripción
AuthorizationBearer <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-Typeapplication/json para peticiones con body JSON.

Petición

El path gdsprovider actualmente es 0. El body requiere un array no vacío offerIds de strings.

Schema de parámetros

gdsprovider
enum
0
Sí
Currently 0

Schema del body

offerIds
arraySí
offerIds[]
string[]Sí

Respuesta exitosa

Devuelve booking con bookingId, expiresAt, términos y condiciones, precio total, pasajeros y fees extra.

Schema de respuesta

booking
objectSí
bookinggdsprovider
numberSí
bookingbookingId
stringSí
bookingexpiresAt
string
Formato: ISO 8601
Sí
bookingtermsAndConditions
arraySí
bookingtermsAndConditions[]
string[]Sí
bookingtotalPrice
objectSí
bookingtotalPriceamount
numberSí
bookingtotalPricecurrency
stringSí
bookingpassengers
arraySí
bookingpassengers[]id
stringSí
bookingpassengers[]type
enum
youthadultsenior
Sí
bookingextraFees
arraySí
bookingextraFees[]amount
numberNo
bookingextraFees[]currency
stringNo

Errores

  • 400 por validación o campos desconocidos.
  • 401 o 403 por credenciales API inválidas.
  • 500 internal_communication_error o unknown_error por fallos del proveedor.
  • booking_not_found cuando una oferta no puede pre-reservarse o expiró.

Notas de uso

Conserva bookingId y completa la orden antes de expiresAt.

Ejemplo cURL

bash
bash
curl --request POST \
  --url "https://api.sandbox.travelandz.com/v1/trains/book/0/prebook" \
  --header "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
  --header "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE" \
  --header "Content-Type: application/json" \
  --data '{"offerIds":["offer_123"]}'