Parámetros de la solicitud
Consulte una aerolínea o exporte el directorio y lea después lowcost, type y type_code. Con onlyscheduled controla los tipos cubiertos. El endpoint documentado no tiene parámetros de consulta lowcost ni type_code; aplique esos filtros en su aplicación a los registros devueltos.
| Parámetro | Obligatorio | Predeterminado | Descripción |
|---|
apikey |
Sí | Ninguno | Su clave de API asignada. Solicitar una clave de prueba de API gratuita. |
|---|
iata |
Condicional | Ninguno | Consulta de una aerolínea por su código IATA de dos caracteres, por ejemplo UA. |
|---|
icao |
Condicional | Ninguno | Consulta de una aerolínea por su código ICAO de tres letras, por ejemplo UAL. |
|---|
name |
Condicional | Ninguno | Búsqueda de códigos de aerolíneas por el nombre completo o parcial de la aerolínea. |
|---|
dump |
Condicional | 0 | Con 1 exporta el conjunto de datos completo, según el filtro onlyscheduled. |
|---|
response_type |
No | JSON | Formato de respuesta: JSON, XML o CSV. CSV inicia la descarga de un archivo. |
|---|
onlyscheduled |
No | 1 | Con 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 →
Tareas habituales de implementación
Descargar las clasificaciones y filtrarlas
Exporte con dump=1 y onlyscheduled=0 para incluir también categorías que no sean aerolíneas regulares. En su aplicación, elija lowcost igual a 1 para las aerolíneas low cost o un type_code como 2 para chárter de pasajeros u 8 para carga. Uniformice los strings numéricos antes de comparar valores y mantenga la clasificación low cost separada del tipo de aerolínea.
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 airline-metadata.csv
Encontrar los metadatos por el nombre de la aerolínea
Busque con name, confirme la aerolínea que necesite y lea sus campos de clasificación. Con onlyscheduled=0 busca más allá de las aerolíneas regulares. La búsqueda por nombre admite coincidencias parciales y puede devolver varios registros. Revise las aerolíneas devueltas antes de aplicar etiquetas.
curl --get 'https://content.airhex.com/api/v3.7.10/airlines/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'name=United' \
--data-urlencode 'onlyscheduled=0'
Obtener las clasificaciones con un código ICAO
Use icao cuando su fuente aporte un código de aerolínea de tres letras. El ejemplo consulta United Airlines con UAL. Añada onlyscheduled=0 si su consulta debe cubrir también otros tipos de operador.
curl --get 'https://content.airhex.com/api/v3.7.10/airlines/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'icao=UAL' \
--data-urlencode 'onlyscheduled=0'
Preguntas frecuentes
¿Qué devuelve la API de metadatos de aerolíneas?
Esta página trata de lowcost, type y type_code en la respuesta de la API de aerolíneas. Contienen el indicador low cost, la etiqueta de categoría y el código de categoría correspondiente, junto con nombres e identificadores de aerolíneas.
¿Qué significan los valores de lowcost?
1 indica una aerolínea low cost. 0 significa que el registro no está marcado como low cost. Es una clasificación de la aerolínea y no dice nada sobre el precio o las prestaciones de una tarifa concreta. El equipaje incluido y las prestaciones incluidas los obtiene de los datos de tarifas de su proveedor de reservas.
¿Una aerolínea puede ser regular y low cost a la vez?
Sí. Regular es una categoría de aerolínea; lowcost, un indicador independiente. Use ambos campos si su aplicación necesita aerolíneas low cost regulares: la categoría con type_code y la clasificación low cost con lowcost.
¿Qué tipos de aerolínea existen?
Los códigos documentados son 1 Regular, 2 Chárter de pasajeros, 3 Tren/autobús/ferri, 4 Chárter de helicópteros, 5 Chárter de jets, 6 Vuelos panorámicos, 7 ACMI, 8 Carga y 9 Otros. Use type_code para los filtros de categoría y type para la etiqueta que se entrega.
¿Cómo obtengo operadores chárter o de carga?
Establezca onlyscheduled=0 para incluir tipos que no sean aerolíneas regulares. Para un directorio, exporte con dump=1 y filtre en local por type_code 2 para chárter de pasajeros u 8 para carga. El chárter de helicópteros y el de jets tienen sus propios códigos, 4 y 5.
¿Puedo enviar lowcost o type_code como parámetro de consulta?
Son campos de la respuesta, no filtros de solicitud documentados. Obtenga los registros que necesite y filtre en su aplicación. El parámetro de solicitud documentado es onlyscheduled, para cubrir solo aerolíneas regulares o un alcance de tipos más amplio. El valor predeterminado es 1. Indique 0 para una cobertura más amplia y elija después de forma explícita las categorías de aerolínea si su directorio debe excluir los registros de tren, autobús y ferri.
¿onlyscheduled=1 significa que la aerolínea está activa?
No. La categoría de aerolínea y el estado operativo son características independientes. Lea el campo status si necesita distinguir entre aerolíneas activas, inactivas y en fase de lanzamiento.
¿Puedo guardar los metadatos de aerolíneas en mi propia base de datos?
Sí, con una licencia adecuada de la base de datos de aerolíneas. Exporte en JSON, XML o CSV y conserve airhex_id junto con las clasificaciones. Actualice sus registros locales con regularidad; Airhex revisa y actualiza los datos de aerolíneas a diario.
¿Cómo trato los indicadores numéricos y los valores ausentes?
Uniformice los strings numéricos antes de comparar lowcost con 0 o 1. Trate los valores ausentes o inesperados como desconocidos en lugar de etiquetarlos sin avisar.