GET/v1/trains/locations?keyword={keyword}&language={language}

Buscar localidades de tren

Busca estaciones y localidades de tren por palabra clave.

Compartir

Busca estaciones y localidades de tren por palabra clave.

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

Query: keyword es requerido y no puede estar vacío. language es opcional y acepta en, es o zh.

Schema de parámetros

keyword
stringSí
Required search text; it cannot be empty.
language
enum
eneszh
No

Respuesta exitosa

Devuelve locations[] con id, nombre, país, código de país, coordenadas e idioma.

Schema de respuesta

locations
arraySí
locations[]id
stringSí
locations[]name
stringSí
locations[]countryCode
string
Formato: 2-letter country code
Sí
locations[]country
stringSí
locations[]latitude
numberSí
locations[]longitude
numberSí
locations[]language
enum
eneszh
Sí

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.

Notas de uso

Usa los ids devueltos como origin y destination al buscar viajes.

Ejemplo cURL

bash
bash
curl --request GET \
  --url "https://api.sandbox.travelandz.com/v1/trains/locations?keyword=Paris&language=en" \
  --header "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
  --header "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE"