GET/v1/flights/airports

Buscar aeropuertos

Busca metadata de aeropuertos por texto libre o coordenadas cercanas para autocompletados y flujos de búsqueda por ubicación.

GET/v1/flights/airports

Consola API

Pruébalo

Envía una petición real al entorno sandbox e inspecciona la respuesta.

Credenciales

Profile code

Public key

Secret key

Inicia sesión para elegir entre tus API keys guardadas en vez de pegarlas.

Parámetros de consulta

4 campos

queryStringstringOpcional

Texto de búsqueda

Texto libre para buscar por nombre de aeropuerto, ciudad o código IATA.

latnumber -90 to 90Opcional

Latitud

Latitud del punto central para una búsqueda de aeropuertos por radio.

lngnumber -180 to 180Opcional

Longitud

Longitud del punto central para una búsqueda de aeropuertos por radio.

radiusnumber > 0Opcional

Radio (km)

Radio de búsqueda en kilómetros alrededor de las coordenadas indicadas.

Petición cURL

cURL

bash

curl -X GET 'https://api.sandbox.travelandz.com/v1/flights/airports?queryString=Madrid' \
  -H 'Authorization: Bearer YOUR_SECRET_KEY' \
  -H 'X-Travelandz-Id: YOUR_PUBLIC_KEY:YOUR_PROFILE_CODE'

Añade tus credenciales para enviar una petición.

Respuesta

Pulsa «¡Pruébalo!» para enviar una petición y ver la respuesta aquí.

Busca metadata de aeropuertos por texto libre o coordenadas cercanas para autocompletados y flujos de búsqueda por ubicación.

Endpoint

Método	Ruta	Auth
`GET`	`/v1/flights/airports`	API key requerida

Headers obligatorios:

Header	Descripción
`Authorization`	`Bearer <secret_key>`. El secret se muestra una sola vez al crear la credencial.
`X-Travelandz-Id`	`<public_key>:<profile_code>`. El `profile_code` es el codigo de Developer Profile con prefijo `dp_` que ves en el dashboard. Esto vincula la peticion con un perfil y una credencial.
`Content-Type`	Usa `application/json` para peticiones con cuerpo.

Esquema de parámetros de la petición

lat

numberNo

Requerido cuando no se envia queryString

lng

numberNo

Requerido cuando no se envia queryString

radius

numberNo

Requerido cuando no se envia queryString

queryString

stringNo

Alternativa a coordenadas

Cuerpo de la petición

No requiere cuerpo de petición.

Respuesta exitosa

Devuelve aeropuertos coincidentes y metadata de ubicacion.

Esquema del cuerpo de la respuesta

airports

arraySí

airports[]name

stringSí

airports[]city_name

stringSí

airports[]time_zone

stringSí

airports[]longitude

numberSí

airports[]latitude

numberSí

airports[]iata_country_code

stringSí

airports[]iata_code

stringSí

airports[]iata_city_code

stringSí

airports[]type

stringSí

airports[]airportName

stringSí

airports[]distanceFromPoint

numberNo

liveMode

booleanSí

True cuando la peticion se sirve desde el entorno live de Travelandz. Este valor viene de Travelandz, no del payload del proveedor.

Notas operativas

queryString puede usarse para busqueda por texto. Para busqueda geografica, envia lat, lng y radius opcional; el radio por defecto es 30 kilometros.

Ejemplos de query

Busqueda por texto: ?queryString=Barcelona

Busqueda por coordenadas: ?lng=2.080877&lat=41.297273&radius=50

Ejemplo

bash

curl "https://api.sandbox.travelandz.com/v1/flights/airports?queryString=Madrid" \
  -H "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
  -H "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE"

Respuestas

Código	Descripción
`200`	Aeropuertos recuperados correctamente.
`400`	Solicitud inválida: payload no válido.
`401`	No autorizado: credenciales inválidas o ausentes.
`403`	Prohibido: credenciales inválidas.
`500`	Error interno del servidor

200 Cuerpo de la respuesta

Tipo de contenido: application/json

json

{
  "airports": [
    {
      "name": "Barcelona",
      "city_name": "Barcelona",
      "time_zone": "Europe/Madrid",
      "longitude": 2.080877,
      "latitude": 41.297273,
      "iata_country_code": "ES",
      "iata_code": "BCN",
      "iata_city_code": "BCN",
      "type": "airport",
      "airportName": "Barcelona-El Prat Josep Tarradellas Airport"
    },
    {
      "name": "Barcelona",
      "city_name": "Barcelona",
      "time_zone": "America/Caracas",
      "longitude": -64.684271,
      "latitude": 10.103767,
      "iata_country_code": "VE",
      "iata_code": "BLA",
      "iata_city_code": "BLA",
      "type": "airport",
      "airportName": "General Jose Antonio Anzoategui International Airport"
    }
  ],
  "liveMode": false
}