GET/v1/trains/order/:gdsprovider/:orderId

Obtener una orden de tren y sus tickets

Consulta el estado actual de la orden y los recursos de tickets.

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

Parámetros de path: gdsprovider actualmente es 0; orderId viene de la creación de la orden.

Schema de parámetros

gdsprovider

enum

0

Sí

Currently 0

orderId

stringSí

Order id returned by order creation.

Respuesta exitosa

Devuelve order con estado, referencia e itineraryItems[].tickets[]. Los tipos incluyen pdf_ticket, check_in_resource y ticket_on_departure; sus campos pueden ser null.

Schema de respuesta

order

objectSí

ordergdsprovider

numberSí

orderid

stringSí

orderstatus

enum

pendingconfirmedcancelled

Sí

orderreference

stringSí

orderitineraryItems

arraySí

orderitineraryItems[]itineraryIndex

numberSí

orderitineraryItems[]tickets

arraySí

orderitineraryItems[]tickets[]type

enum

pdf_ticketcheck_in_resourceticket_on_departure

Sí

orderitineraryItems[]tickets[]url

stringNullable

orderitineraryItems[]tickets[]reference

stringNullable

orderitineraryItems[]tickets[]description

stringNullable

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.
order_not_found cuando la orden no existe.

Notas de uso

Las URLs de ticket pueden ser recursos del proveedor. Trata url, reference y description null como valores esperados.

Ejemplo cURL

bash

curl --request GET \
  --url "https://api.sandbox.travelandz.com/v1/trains/order/0/order_123" \
  --header "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
  --header "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE"