API de códigos ICAO de aerolíneas

Identifique aerolíneas por los códigos ICAO de tres letras de sus datos de aviación. Obtenga los nombres de las aerolíneas y los códigos IATA correspondientes, o descargue el directorio para conciliar registros 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 ICAO

Envíe el código de aerolínea de tres letras en el parámetro icao de la API de aerolíneas. Este ejemplo consulta Southwest Airlines con SWA. 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 'icao=SWA'

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

Identifique una aerolínea con icao y asóciela con los datos de su sistema de reservas mediante iata, si hay un código IATA. Los campos siguientes siguen el orden de la referencia principal de la API.

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 ICAO, conserve los registros con el campo icao relleno. Revise type_code si quiere excluir otros tipos de operador, como tren, autobús y ferri.

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 ICAO por el nombre de la aerolínea

Busque con name y lea icao 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 IATA con un código ICAO

Envíe el código IATA en iata y lea el campo icao de la respuesta. Así obtiene, a partir de WN de un proveedor de reservas, el código SWA para conciliarlo con un registro de datos de aviación.

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

Qué puede crear

Enriquecer datos de aviación

Convierta los códigos ICAO de aerolíneas de un conjunto de datos de aviación en nombres legibles para paneles e informes.

Conectar datos de reservas y de aviación

Asocie los identificadores IATA de los proveedores de reservas con los identificadores ICAO de otras fuentes y compruebe que ambos registros se refieren a la misma aerolínea.

Directorios de operadores

Cree una consulta local de aerolíneas para operadores regulares, de carga o chárter, con filtros explícitos de tipo y de estado operativo.

Preguntas frecuentes

¿Qué es el código ICAO de una aerolínea?

Un código de aerolínea de tres letras, por ejemplo SWA para Southwest Airlines. Esta página trata de identificadores de aerolíneas; para identificadores de aeropuertos use la API de aeropuertos.

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

Los códigos ICAO de aerolíneas tienen tres letras; los códigos IATA, dos caracteres, y pueden incluir dígitos. La API de aerolíneas devuelve ambos campos cuando existen. Use el parámetro que corresponda al sistema de códigos de su fuente de datos: envíe los códigos ICAO en icao y los IATA en iata.

¿Puedo convertir códigos ICAO de aerolíneas en códigos IATA y al revés?

Consulte un código ICAO con icao y lea iata del resultado, o consulte un código IATA con iata y lea icao. Antes de asociarlos, compruebe que el campo de destino tenga valor; no todos los registros tienen ambos códigos. Conserve el código ICAO y el identificador de la aerolínea aunque no exista una equivalencia IATA.

¿Puedo consultar operadores de carga y chárter?

Establezca onlyscheduled=0 para incluir tipos de aerolínea más allá del filtro predeterminado de aerolíneas regulares. Elija las categorías de operador que necesite con type_code y, si su aplicación solo debe mostrar aerolíneas activas, con status. El valor predeterminado onlyscheduled=1 selecciona las aerolíneas regulares.

¿parent_icao indica la aerolínea operadora de un vuelo?

No. Según la referencia de la API de aerolíneas, parent_icao es el código ICAO de una aerolínea matriz, si procede. La aerolínea operadora de un vuelo concreto se determina con el identificador de su proveedor de vuelos y se consulta por separado.

¿Cómo trato una consulta que no se resuelve?

Conserve el código original de su fuente como alternativa cuando una aerolínea no se pueda resolver y trate las solicitudes fallidas por separado de la falta de resultados. Con coincidencias parciales en la búsqueda por nombre, compare nombres y códigos antes de elegir un registro.

¿Puedo mantener un directorio ICAO de aerolíneas en mi propia base de datos?

Sí, con una licencia adecuada de la base de datos de aerolíneas. Exporte con dump=1 en JSON, XML o CSV y conserve los campos que necesite su integración. Guarde airhex_id junto con las asociaciones de códigos y actualice su copia con regularidad. Airhex revisa y actualiza los datos de aerolíneas a diario; la API de cambios devuelve los cambios más recientes. Al actualizar, conserve la marca de tiempo updated de la respuesta completa.

¿Este endpoint ofrece seguimiento de vuelos o estado de vuelos en tiempo real?

No. Ofrece datos de referencia de aerolíneas para identificarlas y asociar códigos. La información de vuelos en tiempo real la obtiene de su proveedor de datos de vuelos. El campo status describe aquí el estado operativo de la aerolínea, no el de un vuelo concreto.

Cree su consulta de códigos ICAO de aerolíneas

Concilie los identificadores de aerolíneas entre fuentes de datos de aviación y mantenga coherentes los nombres de las aerolíneas en paneles, informes y herramientas para pasajeros.

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.