API de check-in online de aerolíneas

Ayude a los viajeros a llegar directamente al check-in online de su aerolínea desde el itinerario o desde un mensaje previo al viaje. Obtenga las URL de check-in, asociadas a códigos y nombres de aerolíneas y listas para su aplicación de viajes.

Clave de prueba de API Ver el ejemplo
  • Enlaces al check-in online
  • Consulta por código o nombre
  • JSON, XML y CSV

Obtener los enlaces al check-in online de una aerolínea

Consulte Southwest Airlines con el código IATA WN y lea web_checkin_url. Lleve a los viajeros a la página de check-in de la aerolínea con una de las URL devueltas. 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",
    "web_checkin_url": "https://www.southwest.com/air/check-in/?clk=HP-CHKIN",
    ...
  }
]

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

Con la API de aerolíneas consulta una aerolínea o exporta el directorio. web_checkin_url es un campo de la respuesta. La solicitud identifica a la aerolínea; no envía la reserva de un pasajero al check-in.

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

Asocie web_checkin_url con la aerolínea antes de mostrar el enlace. El campo remite a la página de check-in de la aerolínea; no contiene el estado del check-in de un pasajero ni una tarjeta de embarque.

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.
web_checkin_url String (URL)https://www.southwest.com/air/check-in/?clk=HP-CHKINURL del check-in web del pasajero.

Ver todos los datos disponibles →

Tareas habituales de implementación

Descargar los enlaces de check-in de su directorio de aerolíneas

Exporte el directorio como CSV y conserve web_checkin_url junto con nombres de aerolíneas, códigos y airhex_id. Compruebe que haya una URL antes de mostrar un botón de check-in. Use onlyscheduled=0 si necesita tipos de aerolínea que no sean regulares y elija los registros adecuados en 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-check-in-links.csv

Encontrar los enlaces de check-in por el nombre de la aerolínea

Busque con name, confirme la aerolínea que necesite y lea web_checkin_url. La búsqueda por nombre admite coincidencias parciales. Revise las aerolíneas devueltas antes de asociar un enlace a un itinerario.

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

Obtener los enlaces de check-in 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 Southwest Airlines con SWA y devuelve el mismo campo web_checkin_url.

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

Qué puede crear

Botones de check-in en itinerarios

Ofrezca a los viajeros, en su pantalla de gestión de viajes, un enlace bien rotulado a la página de check-in de su aerolínea.

Recordatorios de check-in antes del viaje

Incluya los enlaces de check-in de las aerolíneas en los recordatorios y ajuste el momento de envío a sus datos de reservas o de aerolíneas.

Ayuda con el check-in para atención al cliente

Permita al personal obtener los enlaces al check-in online de la aerolínea a partir del código de aerolínea de una reserva.

Preguntas frecuentes

¿Qué devuelve la API de check-in online de aerolíneas?

La API de aerolíneas devuelve web_checkin_url junto con el identificador de la aerolínea. El campo contiene un enlace a la página de check-in online para pasajeros.

¿La API hace el check-in de los pasajeros o emite tarjetas de embarque?

No. Ofrece las URL de check-in de las aerolíneas. El pasajero hace el check-in con la aerolínea, que comprueba la reserva, registra los datos del pasajero y emite la tarjeta de embarque.

¿La respuesta indica cuándo abre el check-in?

No. El campo documentado devuelve una URL, no horarios de apertura de un vuelo concreto ni datos sobre la elegibilidad del pasajero. El momento en que se puede hacer el check-in lo encuentra en la información de la aerolínea o en los datos de reserva correspondientes. Base los recordatorios y avisos en ese plazo de check-in y no en la existencia de una URL.

¿Puedo rellenar de antemano el código de reserva y el nombre del pasajero?

La API documentada devuelve URL de check-in y no define parámetros para rellenar de antemano datos de pasajeros. No dé por hecho que puede añadir datos de la reserva a una URL devuelta. Use el método de integración documentado de una aerolínea, si lo ofrece.

¿Qué enlace de check-in muestro en vuelos en código compartido?

Determine con la información de check-in de la reserva qué aerolínea es responsable y consúltela. La API de referencia no determina quién es responsable del check-in de un viaje concreto.

¿Qué hago si falta web_checkin_url?

Omita el botón de check-in u ofrezca otra vía de atención al cliente. Una URL ausente no demuestra que la reserva del pasajero no admita check-in online.

¿Puedo guardar los enlaces de check-in en mi propia base de datos?

Sí, con una licencia adecuada de la base de datos de aerolíneas. Exporte el directorio en JSON, XML o CSV y conserve el identificador de la aerolínea junto a cada URL. Actualice su copia 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 de URL.

¿Cómo muestro un enlace de check-in?

Use el valor de web_checkin_url, si existe, como destino de un botón de check-in bien rotulado. Indique el nombre de la aerolínea para que los viajeros sepan qué página se abrirá.

Facilite el acceso al check-in de las aerolíneas

Ofrezca a los viajeros un camino directo desde su itinerario o recordatorio hasta la página de check-in online de su aerolínea, con enlaces mantenidos y asociados a los códigos de aerolínea.

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