API de política de equipaje de aerolíneas

Ayude a los viajeros a encontrar la política de equipaje de su aerolínea directamente en su proceso de reserva o en el itinerario. Obtenga enlaces oficiales a la política, asociados a códigos y nombres de aerolíneas, o descargue el directorio para su propia aplicación.

Clave de prueba de API Ver el ejemplo
  • Enlaces oficiales a la política de equipaje
  • Consulta por código o nombre
  • JSON, XML y CSV

Obtener el enlace a la política de equipaje de una aerolínea

Consulte Southwest Airlines con el código IATA WN y lea baggage_url. Use la URL devuelta como enlace a la política de equipaje en su aplicación. 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",
    "baggage_url": "https://support.southwest.com/helpcenter/pathway/baggage",
    ...
  }
]

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. baggage_url es un campo de la respuesta; no existe un endpoint propio para la política de equipaje ni un parámetro de consulta baggage_url.

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 baggage_url con la aerolínea antes de mostrar el enlace. La API devuelve un enlace a la página de la aerolínea con su política; no devuelve datos estructurados de equipaje incluido, dimensiones ni tarifas de equipaje de una reserva concreta.

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.
baggage_url String (URL)https://support.southwest.com/helpcenter/pathway/baggageURL de la política de equipaje de la aerolínea.

Ver todos los datos disponibles →

Tareas habituales de implementación

Descargar los enlaces a la política de equipaje de su directorio de aerolíneas

Exporte el directorio de aerolíneas como CSV y conserve baggage_url junto con nombres, códigos y airhex_id. Muestre un enlace solo si hay una URL. Use onlyscheduled=0 si necesita también 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-baggage-links.csv

Encontrar la política de equipaje por el nombre de la aerolínea

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

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

Obtener el enlace a la política 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 y devuelve el mismo registro de aerolínea con el campo de la política de equipaje.

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

Qué puede crear

Avisos sobre equipaje durante la reserva

Dé a los viajeros acceso a la política de la aerolínea mientras revisan el itinerario y el equipaje incluido en su reserva.

Comunicación útil antes del viaje

Incluya un enlace bien rotulado a la política de equipaje de la aerolínea en las confirmaciones de reserva y en los mensajes previos a la salida.

Atención al cliente más rápida

Permita al personal encontrar el enlace a la política de la aerolínea de una reserva sin mantener su propia lista de URL.

Preguntas frecuentes

¿Qué devuelve la API de política de equipaje de aerolíneas?

El campo baggage_url contiene una URL a la política de equipaje de la aerolínea. Viene en el registro de la API de aerolíneas, junto con el nombre de la aerolínea, los códigos y otros datos de referencia.

¿La API devuelve pesos, dimensiones o tarifas de equipaje?

El campo devuelve una URL a la política, no datos estructurados de equipaje incluido ni de precios. Los viajeros siguen el enlace a la política de la aerolínea. El equipaje incluido en cada reserva y las opciones de equipaje que se pueden comprar los obtiene de su proveedor de reservas.

¿Puedo saber con el enlace qué incluye una tarifa?

No. Un enlace general a la política de una aerolínea no acredita el derecho a equipaje de una reserva concreta. Use el equipaje incluido que indiquen la tarifa o la reserva elegidas y ofrezca el enlace como información adicional.

¿Puedo obtener la política por código IATA, código ICAO o nombre?

Sí. Consulte un registro de aerolínea con iata, icao o name y lea baggage_url. La búsqueda por nombre admite coincidencias parciales; confirme la aerolínea devuelta antes de usar su enlace.

¿Qué enlace muestro en vuelos en código compartido o con varias aerolíneas?

Asocie cada enlace con el registro de la aerolínea al que pertenece y rotúlelo con el nombre de esa aerolínea. No decida solo con este campo qué normas se aplican a la reserva; use la información de equipaje de la reserva. Un rótulo claro como “Ver la política de equipaje de la aerolínea” indica a los viajeros qué se abrirá.

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

No muestre un enlace vacío ni roto. Omita el botón o ofrezca en su aplicación otra vía de atención al cliente. La ausencia de datos no demuestra que la aerolínea permita o excluya cierto equipaje, ni que no tenga política de equipaje.

¿Puedo guardar los enlaces a la política de equipaje en mi propia base de datos?

Sí, con una licencia adecuada de la base de datos de aerolíneas. Exporte con dump=1 en JSON, XML o CSV y conserve el identificador de la aerolínea junto a cada URL. 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 que las importaciones recojan las URL modificadas.

¿La API devuelve el texto de la política o versiones traducidas?

El campo documentado baggage_url devuelve una URL, no el texto de la política ni variantes de idioma. El contenido y los idiomas disponibles dependen de la página de la aerolínea.

Ayude a los viajeros a encontrar la política de equipaje de su aerolínea

Coloque los enlaces a las políticas de las aerolíneas donde los viajeros los necesitan, en procesos de reserva, itinerarios y herramientas de atención al cliente, sin mantener su propio directorio de URL.

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.

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.