API de alianzas aéreas

Ayude a los viajeros a encontrar aerolíneas de su alianza aérea preferida. Obtenga la pertenencia a una alianza junto con nombres y códigos de aerolíneas para incorporar etiquetas de alianza, filtros y comparaciones de aerolíneas a su aplicación de viajes.

Clave de prueba de API Ver el ejemplo
  • Pertenencia a una alianza
  • Consulta por código o nombre
  • JSON, XML y CSV

Consultar la alianza de una aerolínea

Consulte United Airlines con el código IATA UA y lea alliance. El ejemplo devuelve Star Alliance. 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=UA'

Respuesta · extracto JSON

[
  {
    "iata": "UA",
    "icao": "UAL",
    "marketing_name": "United Airlines",
    "alliance": "Star Alliance",
    ...
  }
]

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 exporte el directorio y lea después alliance en los registros devueltos. El endpoint documentado no tiene un parámetro de consulta alliance; agrupe o filtre los registros 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 UA.
icao CondicionalNingunoConsulta de una aerolínea por su código ICAO de tres letras, por ejemplo UAL.
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

Muestre con alliance la pertenencia a una alianza junto a la aerolínea. Conserve status si crea un directorio de miembros activos y airhex_id al actualizar sus registros locales.

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

Ver todos los datos disponibles →

Tareas habituales de implementación

Descargar el directorio y agrupar las aerolíneas por alianza

Exporte el directorio como CSV y agrupe los registros en su aplicación por el campo alliance. Filtre por el nombre de alianza devuelto para crear una lista de miembros y revise status si solo quiere mostrar aerolíneas activas. onlyscheduled=0 amplía los tipos de aerolínea cubiertos; elija los registros adecuados con type_code.

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-alliances.csv

Encontrar la alianza de una aerolínea por su nombre

Busque con name, elija la aerolínea que necesite y lea alliance. La búsqueda por nombre admite coincidencias parciales y puede devolver varios registros, así que confirme la aerolínea antes de mostrar su alianza.

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

Obtener la alianza con un código ICAO

Use icao cuando su fuente aporte un código ICAO de tres letras de la aerolínea. El ejemplo consulta United Airlines con UAL y lee alliance del mismo registro de aerolínea.

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

Qué puede crear

Filtros por alianza en la búsqueda de vuelos

Asocie los códigos de aerolínea de sus proveedores con su directorio y deje que los viajeros acoten los resultados por alianza aérea, tratando con claridad las aerolíneas comercializadora y operadora.

Páginas de comparación de aerolíneas

Muestre la alianza registrada junto al nombre de cada aerolínea para que los viajeros comparen aerolíneas con más facilidad.

Directorios de miembros de alianzas

Agrupe los registros de aerolíneas por pertenencia y cree listas para consultar e informes internos.

Preguntas frecuentes

¿Qué devuelve la API de alianzas aéreas?

El campo alliance indica la alianza a la que pertenece una aerolínea, si existe. Forma parte del registro de la API de aerolíneas, junto con nombres de aerolíneas, códigos IATA, códigos ICAO y otros datos de referencia.

¿Puedo obtener todas las aerolíneas de una alianza concreta?

Exporte el directorio con dump=1 y filtre en su aplicación los valores de alliance devueltos. El endpoint documentado no tiene un parámetro de solicitud para la alianza. Revise status si su lista de miembros solo debe incluir aerolíneas activas. Forme grupos con los valores de alliance que tengan contenido y conserve nombres y códigos en cada registro para asociar aerolíneas en los resultados de búsqueda.

¿Puedo consultar la pertenencia por código IATA, código ICAO o nombre?

Sí. Obtenga registros de aerolíneas con iata, icao o name y lea alliance. La búsqueda por nombre admite coincidencias parciales; elija la aerolínea que necesite antes de usar el resultado.

¿Qué muestro si alliance está vacío?

Omita la etiqueta de alianza o muestre “Sin alianza registrada”, según el diseño de su producto. No deduzca una pertenencia a partir de una aerolínea matriz, un socio de código compartido o un nombre de aerolínea parecido.

¿Pertenecer a una alianza significa que los pasajeros acumulan millas o pueden usar salas VIP?

No. El campo describe la pertenencia de la aerolínea y no determina los beneficios de un pasajero o de una reserva concretos. La elegibilidad se aclara con las reglas del programa de viajero frecuente correspondiente y los datos de la reserva.

¿Cómo deben tratar los filtros por alianza los vuelos en código compartido?

Decida si su filtro se aplica a la aerolínea comercializadora, a la operadora o a ambas, y explíquelo a los viajeros. Consulte por separado cada aerolínea que figure en el itinerario; el campo alliance no determina las relaciones de código compartido de un vuelo.

¿Puedo guardar la pertenencia a una alianza 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 el identificador de la aerolínea junto con el valor de alliance. Actualice su directorio con regularidad; Airhex revisa y actualiza los datos de aerolíneas a diario. Guarde airhex_id y la marca de tiempo updated de la respuesta completa para recoger los cambios de pertenencia y de estado de la aerolínea.

¿La API devuelve pertenencias anteriores a alianzas?

El campo documentado alliance indica la pertenencia registrada en el registro de la aerolínea. No hay períodos de pertenencia ni consultas a una fecha determinada. Cree sus propias instantáneas con fecha si sus informes necesitan comparaciones históricas.

Ayude a los viajeros a encontrar aerolíneas de su alianza preferida

Incorpore filtros por alianza y etiquetas de pertenencia a su producto de viajes sin mantener usted mismo las listas de miembros de las aerolíneas.

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 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.