API de estado de aerolíneas

Compruebe si una aerolínea está activa, inactiva o aún en fase de lanzamiento. Obtenga el estado operativo junto con los códigos y los nombres de las aerolíneas para mantener su directorio y crear listas de selección de aerolíneas adecuadas.

Clave de prueba de API Ver el ejemplo
  • Activa, inactiva, en fase de lanzamiento
  • Consulta por código o nombre
  • JSON, XML y CSV

Comprobar el estado operativo de una aerolínea

Consulte Southwest Airlines con el código IATA WN y lea el campo status. El valor 1 significa que la aerolínea está activa. 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",
    "status": 1,
    ...
  }
]

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

Consulte una aerolínea o descargue el directorio y lea después el campo status de la respuesta. El endpoint documentado no tiene un parámetro de consulta status; aplique los filtros de estado en su aplicación.

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

Lea status siempre junto con el identificador de la aerolínea. Los valores son 1 para activa, 0 para inactiva y 2 para una aerolínea en fase de lanzamiento que aún no ha iniciado operaciones. Conserve airhex_id al 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 (aún no ha iniciado operaciones).

Ver todos los datos disponibles →

Tareas habituales de implementación

Descargar el directorio y filtrar por estado

Exporte el directorio como CSV y filtre la columna status en su aplicación: 1 para aerolíneas activas, 0 para inactivas, 2 para aerolíneas en fase de lanzamiento. onlyscheduled=0 amplía los tipos de aerolínea cubiertos; no es un filtro de aerolíneas activas. Revise type_code si quiere excluir registros de tren, autobús o 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 airline-status.csv

Encontrar el estado de una aerolínea por su nombre

Busque con name, elija entre los resultados la aerolínea que necesite y lea status. La búsqueda por nombre puede devolver varias aerolíneas. Añada onlyscheduled=0 si quiere buscar más allá de las aerolíneas regulares.

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

Comprobar el estado con un código ICAO

Use icao cuando su fuente identifique la aerolínea con un código ICAO de tres letras. El ejemplo consulta Southwest Airlines con SWA. Lea el valor status devuelto en lugar de deducir el estado operativo de la mera existencia de un código.

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

Qué puede crear

Comprobar aerolíneas activas en herramientas de reserva

Cree una lista de selección con los registros con status 1 y aplique los filtros de tipo que necesite su producto.

Informes de viajes anteriores

Conserve los identificadores de aerolíneas inactivas para explicar reservas, itinerarios y transacciones anteriores.

Mantenimiento del directorio

Compare los registros actualizados mediante airhex_id y marque los cambios de estado para su revisión en sus herramientas internas.

Preguntas frecuentes

¿Qué significan los valores de estado?

1 significa activa, 0 inactiva y 2 una aerolínea en fase de lanzamiento que aún no ha iniciado operaciones. Los valores describen a la aerolínea como empresa.

¿“Activa” significa que se puede reservar un vuelo?

No. El estado “activa” no dice nada sobre la disponibilidad en una ruta o en una fecha. La disponibilidad de vuelos y las tarifas las obtiene de su proveedor de reservas.

¿Puedo consultar solo las aerolíneas activas?

La API de aerolíneas documentada no tiene un parámetro de consulta status. Obtenga los registros que necesite y filtre en su aplicación por status igual a 1. onlyscheduled=1 selecciona tipos de aerolínea regulares; no sustituye la comprobación del estado. Compare de forma explícita con 1: una comprobación de “distinto de cero” incluiría también las aerolíneas en fase de lanzamiento con status 2.

¿Cómo encuentro aerolíneas inactivas o en fase de lanzamiento?

Exporte el directorio y filtre los registros por status 0 o 2. Establezca onlyscheduled=0 si necesita todos los tipos de operador. Para una aerolínea concreta, consulte el código o el nombre y revise el status devuelto.

¿La ausencia de un código de aerolínea significa que ha cesado sus operaciones?

No. La falta de un código o una consulta sin resolver no es un estado operativo. Conserve el identificador original y revise el resultado en lugar de marcar la aerolínea como inactiva. Asigne un estado operativo solo si un registro devuelto contiene un valor de estado conocido.

¿Debo eliminar las aerolíneas inactivas de mi base de datos?

Conserve los registros que necesite para reservas o informes históricos. Puede excluir los registros con status 0 de las listas de selección actuales sin borrar su identificador histórico. Con airhex_id asocia las importaciones futuras con los registros existentes.

¿Cómo mantengo actualizado el estado de las aerolíneas?

Airhex revisa y actualiza los datos de aerolíneas a diario. Actualice sus registros locales con regularidad y conserve airhex_id y la marca de tiempo updated de la respuesta completa. La API de cambios devuelve los cambios más recientes, incluidos los cambios de estado, para que pueda vigilarlos.

¿Es una API de estado de vuelos en tiempo real?

No. Ofrece el estado operativo de las aerolíneas, no salidas, llegadas, retrasos ni cancelaciones. El estado de cada vuelo lo obtiene de un proveedor de datos de vuelos.

Mantenga actualizado su directorio de aerolíneas

Mantenga visibles las aerolíneas activas en las listas de selección actuales y conserve los identificadores de las aerolíneas inactivas para reservas e informes históricos.

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.