API de códigos IATA de aerolíneas

Convierta un código de aerolínea de dos caracteres en un nombre reconocible. Obtenga los códigos IATA junto con los códigos ICAO y las identidades de las aerolíneas, o descargue el directorio para usarlo en su propia aplicación.

Clave de prueba de API Ver el ejemplo
  • Consulta por código o nombre
  • JSON, XML y CSV
  • Consulta individual o exportación completa

Consultar una aerolínea por su código IATA

Envíe el código de la aerolínea en el parámetro iata de la API de aerolíneas. Este ejemplo consulta Southwest Airlines con WN. Sustituya YOUR_API_KEY por su clave de API.

Solicitud · cURL

curl --get 'https://content.airhex.com/api/v3.7.10/airlines/' \
  --data-urlencode 'apikey=YOUR_API_KEY' \
  --data-urlencode 'iata=WN'

Respuesta · extracto JSON

[
  {
    "iata": "WN",
    "icao": "SWA",
    "marketing_name": "Southwest Airlines",
    ...
  }
]

Respuesta abreviada. Los puntos suspensivos (…) representan otros campos de la aerolínea que aquí se omiten y no forman parte de la respuesta JSON real.

Ver la referencia completa: API de aerolíneas →

Parámetros de la solicitud

Use estos parámetros de consulta para buscar códigos de aerolíneas o exportar el directorio.

ParámetroObligatorioPredeterminadoDescripción
apikey SíNingunoSu clave de API asignada. Solicitar una clave de prueba de API gratuita.
iata CondicionalNingunoConsulta de una aerolínea por su código IATA de dos caracteres, por ejemplo WN.
icao CondicionalNingunoConsulta de una aerolínea por su código ICAO de tres letras, por ejemplo SWA.
name CondicionalNingunoBúsqueda de códigos de aerolíneas por el nombre completo o parcial de la aerolínea.
dump Condicional0Con 1 exporta el conjunto de datos completo, según el filtro onlyscheduled.
response_type NoJSONFormato de respuesta: JSON, XML o CSV. CSV inicia la descarga de un archivo.
onlyscheduled No1Con 1 devuelve solo aerolíneas regulares; con 0, todos los tipos de aerolínea.

Indique al menos uno de los parámetros iata, icao, name o dump=1. Con dump=1 se ignoran los demás parámetros de consulta.

Ver todos los parámetros de la solicitud →

Datos disponibles

Consulte la aerolínea por su código IATA y use los campos asociados para mostrar nombres, asociar identificadores y mantener sus registros locales.

CampoTipoEjemploDescripción
airhex_id Identificador1046Identificador permanente del registro en Airhex. Úselo para asociar futuras actualizaciones al mismo registro.
iata StringWNCódigo IATA de dos caracteres de la aerolínea. Los códigos pueden contener letras y dígitos; guárdelos como texto.
icao StringSWACódigo ICAO de tres letras de la aerolínea, útil para pasar de un sistema de códigos a otro.
marketing_name StringSouthwest AirlinesNombre comercial de la aerolínea para mostrar en su aplicación.
status Integer1Estado operativo: 1 = activa, 0 = inactiva, 2 = en fase de lanzamiento.

Ver todos los datos disponibles →

Tareas habituales de implementación

Descargar el directorio de códigos de aerolíneas

Con dump=1 se exporta la base de datos. Añada onlyscheduled=0 para incluir todos los tipos de aerolínea y no solo el filtro predeterminado de aerolíneas regulares. El ejemplo en CSV se puede importar a su propia base de datos; si crea una tabla de consulta de códigos, conserve solo los registros con código IATA.

curl --get 'https://content.airhex.com/api/v3.7.10/airlines/' \
  --data-urlencode 'apikey=YOUR_API_KEY' \
  --data-urlencode 'dump=1' \
  --data-urlencode 'onlyscheduled=0' \
  --data-urlencode 'response_type=CSV' \
  --output airlines.csv

Encontrar el código IATA por el nombre de la aerolínea

Busque con name y lea iata de cada registro devuelto. La búsqueda por nombre admite coincidencias parciales, así que revise las aerolíneas devueltas en lugar de dar por único el primer resultado.

curl --get 'https://content.airhex.com/api/v3.7.10/airlines/' \
  --data-urlencode 'apikey=YOUR_API_KEY' \
  --data-urlencode 'name=Southwest'

Asociar un código ICAO con un código IATA

Envíe el código ICAO en icao y lea el campo iata de la respuesta. Así concilia los identificadores de aerolíneas de distintas fuentes de datos.

curl --get 'https://content.airhex.com/api/v3.7.10/airlines/' \
  --data-urlencode 'apikey=YOUR_API_KEY' \
  --data-urlencode 'icao=SWA'

Qué puede crear

Resultados de vuelos e itinerarios

Sustituya los códigos de aerolínea de los resultados de reserva, las páginas de confirmación y los itinerarios por nombres legibles.

Conciliación de datos e informes

Vincule los registros con códigos IATA a fuentes que usan códigos ICAO y tenga a mano los nombres de las aerolíneas para sus informes.

Selectores de aerolíneas

Rellene listas desplegables y buscadores de aerolíneas con un directorio local y muestre juntos códigos y nombres.

Preguntas frecuentes

¿En qué se diferencian los códigos IATA de aerolíneas de los códigos de aeropuertos y de los códigos ICAO?

Un código IATA de aerolínea tiene dos caracteres, por ejemplo WN para Southwest Airlines, y puede incluir dígitos. Los códigos IATA de aeropuertos identifican lugares y tienen tres letras. Los códigos ICAO de aerolíneas son un sistema propio de tres letras; el código ICAO de Southwest es SWA.

¿Puedo asociar las aerolíneas de mi proveedor de reservas de vuelos?

Si su proveedor entrega un código IATA, envíelo en el parámetro iata y obtendrá el nombre y los datos de referencia asociados. Si entrega códigos ICAO, use icao. Antes de asociar, aclare qué sistema de códigos usa cada campo del proveedor.

¿Cómo trato las aerolíneas comercializadora y operadora?

Use los identificadores de la aerolínea comercializadora y de la operadora del vuelo y consúltelos por separado. Después puede mostrar la aerolínea comercializadora y añadir, si lo necesita, “operado por”. Este endpoint de referencia no determina qué aerolínea opera un vuelo concreto.

¿Todos los registros de aerolíneas tienen código IATA?

No dé por hecho que sí. Compruebe que el campo iata tenga valor antes de incluir un registro en su tabla de consulta IATA. Use airhex_id como clave permanente en su directorio local y no el código de la aerolínea.

¿Cómo debe tratar mi integración los resultados ausentes o ambiguos?

Trate las solicitudes fallidas por separado de las consultas sin aerolínea coincidente. Muestre el código original del proveedor como alternativa si no se puede resolver. La búsqueda por nombre admite coincidencias parciales: compare los nombres y códigos devueltos en lugar de adoptar automáticamente el primer registro.

¿Puedo descargar el directorio y guardarlo en mi propia base de datos?

Sí, con una licencia adecuada de la base de datos de aerolíneas. Con dump=1 exporta el directorio en JSON, XML o CSV; establezca onlyscheduled=0 si necesita todos los tipos de aerolínea. Con una copia local resuelve los nombres de aerolíneas sin enviar una solicitud a la API por cada resultado de vuelo. Aclare los derechos de uso para su integración al solicitar la licencia.

¿Cómo mantengo actualizados los códigos de aerolíneas?

Airhex revisa y actualiza los datos de aerolíneas a diario. Actualice su directorio local de forma periódica y conserve airhex_id y updated al importar. La API de cambios devuelve los cambios más recientes; con ella puede vigilar los cambios y obtener los registros actuales de la API de aerolíneas. Para planificar su proceso de actualización, consulte la referencia completa de la API de aerolíneas y la documentación de la API de cambios.

¿La API incluye disponibilidad de vuelos, tarifas o estado de vuelos?

No. Este endpoint ofrece datos de referencia para identificar y mostrar aerolíneas. La disponibilidad, las tarifas y el estado de cada vuelo los obtiene de su proveedor de vuelos. El campo status describe aquí el estado operativo de la aerolínea, no el estado de un vuelo.

¿Qué tipos de aerolínea debo incluir?

El filtro predeterminado onlyscheduled=1 selecciona las aerolíneas regulares. Con onlyscheduled=0 obtiene todos los tipos de aerolínea. Revise status si su aplicación solo debe mostrar aerolíneas activas.

Cree su consulta de códigos IATA

Convierta los códigos de aerolínea de sus proveedores en nombres reconocibles en resultados de búsqueda, itinerarios e información para pasajeros, sin mantener su propio directorio de códigos.

Clave de prueba de APISolicitar cotización →

API de aerolíneas →

Explore el conjunto de datos completo de aerolíneas: códigos IATA e ICAO, nombres, estado operativo, tipos de aerolínea, alianzas, programas de viajero frecuente, enlaces al check-in online y a la política de equipaje, logos y colores de marca. Todos los parámetros de la solicitud y los campos de la respuesta, con consultas individuales y exportación completa en JSON, XML y CSV.

API de alianzas aéreas →

Consulte la alianza de una aerolínea por código IATA, código ICAO o nombre. Cree filtros por alianza y agrupe aerolíneas en su aplicación de viajes con Airhex.

API de programas de viajero frecuente →

Consulte el programa de viajero frecuente de cada aerolínea por código IATA, ICAO o nombre, y cree directorios de fidelización y perfiles más completos con Airhex.

API de metadatos de aerolíneas →

Obtenga el indicador low cost y los tipos de aerolínea, como regular, chárter, carga y ACMI. Consulte metadatos de aerolíneas por código o nombre con Airhex.

API de check-in online de aerolíneas →

Obtenga los enlaces al check-in online de las aerolíneas por código IATA, código ICAO o nombre e intégrelos en itinerarios y mensajes previos al viaje con Airhex.

API de estado de aerolíneas →

Consulte el estado operativo de una aerolínea (activa, inactiva o en fase de lanzamiento) por código o nombre y filtre su directorio local con Airhex.