API de programas de viajero frecuente

Asocie aerolíneas con los nombres de sus programas de viajero frecuente. Obtenga los nombres de los programas junto con los códigos de aerolínea para enriquecer perfiles de aerolíneas, crear directorios de programas de fidelización y dar contexto útil a su aplicación de viajes.

Clave de prueba de API Ver el ejemplo
  • Nombres de programas de viajero frecuente
  • Consulta por código o nombre
  • JSON, XML y CSV

Consultar el programa de viajero frecuente de una aerolínea

Consulte United Airlines con el código IATA UA y lea ffp_name. El ejemplo devuelve MileagePlus. 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",
    "ffp_name": "MileagePlus",
    ...
  }
]

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 ffp_name en los registros devueltos. El parámetro name busca en los nombres de aerolíneas, no en los nombres de los programas de viajero frecuente. Filtre los nombres de programas en su aplicación una vez obtenidos los registros.

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 ffp_name el programa asociado al registro de la aerolínea. Conserve el identificador de la aerolínea junto al nombre del programa al crear o actualizar un directorio local.

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.
ffp_name StringMileagePlusNombre del programa de viajero frecuente de la aerolínea.

Ver todos los datos disponibles →

Tareas habituales de implementación

Descargar los nombres de los programas de viajero frecuente

Exporte el directorio como CSV y conserve ffp_name junto con nombres de aerolíneas, códigos y airhex_id. Cree un directorio con los nombres de programas que tengan valor. Establezca onlyscheduled=0 si necesita tipos de aerolínea que no sean regulares y elija después los registros relevantes para su aplicación.

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-frequent-flyer-programs.csv

Encontrar el programa por el nombre de la aerolínea

Busque con el nombre de la aerolínea, elija el registro que necesite y lea ffp_name. La búsqueda por nombre admite coincidencias parciales y puede devolver varias aerolíneas, así que confirme la aerolínea antes de mostrar un programa. Para buscar por el nombre de un programa, filtre en local el directorio descargado.

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

Obtener el nombre del programa 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 y lee el nombre del programa de viajero frecuente del mismo registro.

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

Qué puede crear

Perfiles de aerolíneas más completos

Muestre el programa de viajero frecuente registrado junto al nombre de la aerolínea y otra información de referencia.

Directorios de programas de fidelización

Cree un directorio fácil de consultar que relacione nombres y códigos de aerolíneas con sus programas de viajero frecuente registrados.

Contexto para los equipos de atención al viajero

Ofrezca al personal, al revisar una reserva, el nombre del programa de la aerolínea y asocie las preguntas sobre la cuenta y los beneficios con el programa correspondiente.

Preguntas frecuentes

¿Qué devuelve la API de programas de viajero frecuente?

El campo ffp_name devuelve el nombre del programa de viajero frecuente de la aerolínea. Está incluido en el registro de la API de aerolíneas, junto con nombres de aerolíneas, códigos y otros datos de referencia.

¿Puedo consultar un programa con un código de aerolínea?

Sí. Envíe un código IATA en iata o un código ICAO en icao y lea ffp_name. También puede buscar por el nombre de la aerolínea.

¿Puedo buscar directamente por el nombre de un programa de viajero frecuente?

El parámetro documentado name busca en los nombres de aerolíneas, no en los de programas. Exporte el directorio con dump=1 y busque o filtre ffp_name en local si su aplicación necesita una búsqueda por nombre de programa.

¿La API devuelve saldos de millas o comprueba números de socio?

No. ffp_name forma parte de los datos de referencia de la aerolínea. La API no ofrece cuentas de pasajeros, saldos de millas, comprobación de afiliaciones ni acceso a una cuenta de fidelización.

¿Puedo saber con ffp_name en qué programa puede acumular millas un pasajero por un vuelo?

No. El campo indica el programa registrado en el registro de la aerolínea y no todos los programas asociados que se aceptan en una reserva concreta. La acumulación de millas y la elegibilidad se aclaran con las reglas de la tarifa y del programa. El nombre por sí solo no dice nada sobre cantidades de millas ni beneficios para los pasajeros.

¿El nombre de un programa es un identificador único?

La documentación de la API no define ffp_name como identificador único del programa. Registre la asociación con la aerolínea mediante airhex_id y sus códigos, y no use el nombre mostrado como clave permanente del registro.

¿Qué hago si ffp_name está vacío?

Omita la etiqueta del programa o muestre “Sin programa registrado”, según el diseño de su producto. Un valor vacío no demuestra si la aerolínea participa en otros acuerdos de fidelización. No deduzca un programa a partir de la alianza ni de la aerolínea matriz.

¿Puedo descargar los nombres de programas y guardarlos 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 a los nombres de programas. Actualice los registros guardados con regularidad; Airhex revisa y actualiza los datos de aerolíneas a diario. Conserve airhex_id y la marca de tiempo updated de la respuesta completa para recoger los cambios en los nombres de programas.

Ayude a los viajeros a reconocer los programas de fidelización de las aerolíneas

Muestre los nombres de los programas de viajero frecuente junto a la información de las aerolíneas y dé a viajeros y equipos de atención un contexto útil, sin mantener su propio directorio de programas.

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