API de aerolíneas: base de datos de aerolíneas y códigos

Convierta los códigos de aerolínea en nombres reconocibles, una marca coherente e información útil para el pasajero. Consulte aerolíneas individuales o descargue el directorio para alimentar los resultados de búsqueda, las reservas y los itinerarios de su producto de viajes.

Clave de prueba de APIVer el ejemplo
  • Consulta por código IATA e ICAO
  • JSON, XML y CSV
  • Consulta individual o exportación completa

Consultar una aerolínea por su código

Envíe un código IATA como WN para obtener Southwest Airlines y sus datos de referencia. Sustituya YOUR_API_KEY por su clave de API.

Descripción del endpoint

Este endpoint ofrece información detallada de aerolíneas. Puede consultar registros individuales o exportar toda la base de datos de aerolíneas en JSON, XML o CSV.

Endpoint
GET https://content.airhex.com/api/v3.7.10/airlines/

Solicitud · cURL

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

Respuesta · JSON

[
    {
        "airhex_id": "1046",
        "updated": "2026-09-08 12:31:16",
        "iata": "WN",
        "icao": "SWA",
        "parent_icao": null,
        "marketing_name": "Southwest Airlines",
        "full_name": "Southwest Airlines Co.",
        "status": "1",
        "type": "SCHEDULED",
        "type_code": "1",
        "alliance": null,
        "ffp_name": "Rapid Rewards",
        "lowcost": "1",
        "country_name": "United States",
        "country_code_alpha_2": "US",
        "country_code_alpha_3": "USA",
        "founded": "1967",
        "baggage_url": "https:\/\/support.southwest.com\/helpcenter\/pathway\/baggage",
        "colorscheme": [
            {
                "color": [
                    220,
                    28,
                    36
                ],
                "percent": 46,
                "hex": "#DC1C24",
                "dark": 1
            },
            {
                "color": [
                    44,
                    66,
                    153
                ],
                "percent": 22,
                "hex": "#2C4299",
                "dark": 1
            },
            {
                "color": [
                    203,
                    203,
                    203
                ],
                "percent": 21,
                "hex": "#CBCBCB",
                "dark": 0
            },
            {
                "color": [
                    251,
                    172,
                    28
                ],
                "percent": 9,
                "hex": "#FBAC1C",
                "dark": 0
            },
            {
                "color": [
                    43,
                    60,
                    132
                ],
                "percent": 2,
                "hex": "#2B3C84",
                "dark": 1
            }
        ],
        "website": "https:\/\/www.southwest.com",
        "web_checkin_url": "https:\/\/www.southwest.com\/air\/check-in\/?clk=HP-CHKIN",
        "mobile_checkin_url": "https:\/\/mobile.southwest.com\/check-in",
        "logo_rectangle": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_700_200_r.png?md5apikey=e742a162ae44192913f94cdc74895b32",
        "logo_square": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_200_200_s.png?md5apikey=cedfc6e88eba47799d33a91523f2a1b9",
        "logo_tail": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_200_200_t.png?md5apikey=8b855307bc1129996236f1fc65290f27",
        "logo_tail_flipped": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_200_200_f.png?md5apikey=33d73ff0ba4bae6f807732bcec857daa",
        "logo_rectangle_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_700_200_r.png?theme=dark&md5apikey=e742a162ae44192913f94cdc74895b32",
        "logo_square_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_200_200_s.png?theme=dark&md5apikey=cedfc6e88eba47799d33a91523f2a1b9",
        "logo_tail_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_200_200_t.png?theme=dark&md5apikey=8b855307bc1129996236f1fc65290f27",
        "logo_tail_flipped_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_200_200_f.png?theme=dark&md5apikey=33d73ff0ba4bae6f807732bcec857daa",
        "logo_rectangle_svg": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_r.svg?md5apikey=0a5c5b380650bd7c7cc5892cfe832ce6",
        "logo_square_svg": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_s.svg?md5apikey=285f91c093bda87be3fa08dfb79a481c",
        "logo_tail_svg": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_t.svg?md5apikey=f154888d47ecc664e5b45ed2fe9166c4",
        "logo_tail_flipped_svg": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_f.svg?md5apikey=cfd3053b5590deb50032556ebf1437c5",
        "logo_rectangle_svg_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_r.svg?theme=dark&md5apikey=0a5c5b380650bd7c7cc5892cfe832ce6",
        "logo_square_svg_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_s.svg?theme=dark&md5apikey=285f91c093bda87be3fa08dfb79a481c",
        "logo_tail_svg_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_t.svg?theme=dark&md5apikey=f154888d47ecc664e5b45ed2fe9166c4",
        "logo_tail_flipped_svg_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_f.svg?theme=dark&md5apikey=cfd3053b5590deb50032556ebf1437c5"
    }
]

Respuesta JSON completa. Desplácese dentro del recuadro para ver todos los campos. Más abajo encontrará ejemplos ampliados en JSON y XML.

Parámetros de la solicitud

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; el filtro onlyscheduled sigue aplicándose.

Parámetro Obligatorio Valor Tipo Predeterminado Descripción
apikey Sí Cualquiera String ninguno Su clave de API. Solicitar una clave de prueba de API gratuita.
iata Condicional 00-ZZ String ninguno Código IATA de dos caracteres de la aerolínea
icao Condicional 000-ZZZ String ninguno Código ICAO de tres letras de la aerolínea
name Condicional Cualquiera String ninguno Nombre de la aerolínea o parte del nombre para una coincidencia parcial
dump Condicional 0 o 1 Integer 0 Indique 1 para exportar toda la base de datos. Prevalece sobre los demás parámetros condicionales de arriba.
response_type No JSON, XML o CSV String JSON Formato de respuesta: JSON, XML o CSV (CSV inicia la descarga de un archivo)
onlyscheduled No 0 o 1 Integer 1 Filtro: solo aerolíneas regulares (1) o todos los tipos de aerolínea, incluidas las de carga, jets privados, etc. (0)
logo_rectangle_width No 1 a 1400 Integer 700 Ancho de las imágenes de logo rectangular
logo_rectangle_height No 1 a 400 Integer 200 Alto de las imágenes de logo rectangular
logo_square_width No 1 a 400 Integer 200 Ancho de los logos cuadrados y de cola
logo_square_height No 1 a 400 Integer 200 Alto de los logos cuadrados y de cola

Campos de la respuesta

Obtenga en un solo registro la identidad, los datos operativos, los enlaces de servicios al pasajero y la marca de una aerolínea. Los campos con enlace llevan a guías detalladas con ejemplos y consejos de integración.

Campo Ejemplo Descripción
airhex_id 1046 Identificador único y permanente del registro
updated 2026-09-08 12:31:16 Fecha y hora de la última actualización del registro
iata WN Código IATA de la aerolínea
icao SWA Código ICAO de la aerolínea
parent_icao Código ICAO de la aerolínea matriz (si procede)
marketing_name Southwest Airlines Nombre comercial de la aerolínea
full_name Southwest Airlines Co. Razón social registrada de la aerolínea
status 1 Estado operativo de la aerolínea: 1 = activa, 0 = inactiva, 2 = en fase de lanzamiento (aún no ha iniciado operaciones)
type SCHEDULED Categoría de la aerolínea: regular, chárter de pasajeros, carga, ACMI, etc.
type_code 1 Código numérico del tipo de aerolínea: 1 = Regular, 2 = Chárter de pasajeros, 3 = Tren/autobús/ferri, 4 = Chárter de helicópteros, 5 = Chárter de jets, 6 = Vuelos panorámicos, 7 = ACMI, 8 = Carga, 9 = Otros
alliance Alianza a la que pertenece la aerolínea (si procede)
ffp_name Rapid Rewards Nombre del programa de viajero frecuente de la aerolínea
lowcost 1 Indica una aerolínea low cost (1 si es low cost, 0 en caso contrario)
country_name United States País de la sede de la aerolínea
country_code_alpha_2 US Código de país (ISO 3166-1 alfa-2) de la sede
country_code_alpha_3 USA Código de país (ISO 3166-1 alfa-3) de la sede
founded 1967 Año de fundación de la aerolínea
website https://www.southwest.com URL del sitio web oficial de la aerolínea
web_checkin_url https://www.southwest.com/air/check-in/?clk=HP-CHKIN URL del check-in online (web)
mobile_checkin_url https://mobile.southwest.com/check-in URL del check-in móvil
baggage_url https://support.southwest.com/helpcenter/pathway/baggage URL de la política de equipaje de la aerolínea
colorscheme [{"color":[220,28,36],"percent":46,"hex":"#DC1C24","dark":1},{"color":[44,66,153],"percent":22,"hex":"#2C4299","dark":1},{"color":[203,203,203],"percent":21,"hex":"#CBCBCB","dark":0},{"color":[251,172,28],"percent":9,"hex":"#FBAC1C","dark":0},{"color":[43,60,132],"percent":2,"hex":"#2B3C84","dark":1}] Array con los colores principales de la marca (valores RGB, porcentajes, códigos hexadecimales e indicaciones de color claro u oscuro)
logo_rectangle https://content.airhex.com/content/logos/airlines_WN_700_200_r.png?md5apikey=e742a162ae44192913f94cdc74895b32 URL directa del logo rectangular de la aerolínea con las dimensiones indicadas y el hash de API seguro
logo_square https://content.airhex.com/content/logos/airlines_WN_200_200_s.png?md5apikey=cedfc6e88eba47799d33a91523f2a1b9 URL directa del logo cuadrado de la aerolínea con las dimensiones indicadas y el hash de API seguro
logo_tail https://content.airhex.com/content/logos/airlines_WN_200_200_t.png?md5apikey=8b855307bc1129996236f1fc65290f27 URL directa del logo de cola de la aerolínea con las dimensiones indicadas y el hash de API seguro
logo_tail_flipped https://content.airhex.com/content/logos/airlines_WN_200_200_f.png?md5apikey=33d73ff0ba4bae6f807732bcec857daa URL directa del logo de aleta de cola de la aerolínea, reflejado horizontalmente, con las dimensiones indicadas y el hash de API seguro
logo_rectangle_dark https://content.airhex.com/content/logos/airlines_WN_700_200_r.png?theme=dark&md5apikey=e742a162ae44192913f94cdc74895b32 URL directa del logo rectangular de la aerolínea, optimizado para fondos oscuros, con las dimensiones indicadas y el hash de API seguro
logo_square_dark https://content.airhex.com/content/logos/airlines_WN_200_200_s.png?theme=dark&md5apikey=cedfc6e88eba47799d33a91523f2a1b9 URL directa del logo cuadrado de la aerolínea, optimizado para fondos oscuros, con las dimensiones indicadas y el hash de API seguro
logo_tail_dark https://content.airhex.com/content/logos/airlines_WN_200_200_t.png?theme=dark&md5apikey=8b855307bc1129996236f1fc65290f27 URL directa del logo de cola de la aerolínea, optimizado para fondos oscuros, con las dimensiones indicadas y el hash de API seguro
logo_tail_flipped_dark https://content.airhex.com/content/logos/airlines_WN_200_200_f.png?theme=dark&md5apikey=33d73ff0ba4bae6f807732bcec857daa URL directa del logo de aleta de cola de la aerolínea, reflejado horizontalmente, optimizado para fondos oscuros, con las dimensiones indicadas y el hash de API seguro
logo_rectangle_svg https://content.airhex.com/content/logos/airlines_WN_r.svg?md5apikey=0a5c5b380650bd7c7cc5892cfe832ce6 URL directa del logo rectangular de la aerolínea en formato vectorial SVG con el hash de API seguro
logo_square_svg https://content.airhex.com/content/logos/airlines_WN_s.svg?md5apikey=285f91c093bda87be3fa08dfb79a481c URL directa del logo cuadrado de la aerolínea en formato vectorial SVG con el hash de API seguro
logo_tail_svg https://content.airhex.com/content/logos/airlines_WN_t.svg?md5apikey=f154888d47ecc664e5b45ed2fe9166c4 URL directa del logo de cola de la aerolínea en formato vectorial SVG con el hash de API seguro
logo_tail_flipped_svg https://content.airhex.com/content/logos/airlines_WN_f.svg?md5apikey=cfd3053b5590deb50032556ebf1437c5 URL directa del logo de aleta de cola de la aerolínea, reflejado horizontalmente, en formato vectorial SVG con el hash de API seguro
logo_rectangle_svg_dark https://content.airhex.com/content/logos/airlines_WN_r.svg?theme=dark&md5apikey=0a5c5b380650bd7c7cc5892cfe832ce6 URL directa del logo rectangular de la aerolínea en formato vectorial SVG, optimizado para fondos oscuros, con el hash de API seguro
logo_square_svg_dark https://content.airhex.com/content/logos/airlines_WN_s.svg?theme=dark&md5apikey=285f91c093bda87be3fa08dfb79a481c URL directa del logo cuadrado de la aerolínea en formato vectorial SVG, optimizado para fondos oscuros, con el hash de API seguro
logo_tail_svg_dark https://content.airhex.com/content/logos/airlines_WN_t.svg?theme=dark&md5apikey=f154888d47ecc664e5b45ed2fe9166c4 URL directa del logo de cola de la aerolínea en formato vectorial SVG, optimizado para fondos oscuros, con el hash de API seguro
logo_tail_flipped_svg_dark https://content.airhex.com/content/logos/airlines_WN_f.svg?theme=dark&md5apikey=cfd3053b5590deb50032556ebf1437c5 URL directa del logo de aleta de cola de la aerolínea, reflejado horizontalmente, en formato vectorial SVG, optimizado para fondos oscuros, con el hash de API seguro

Ejemplos de respuesta completos

Los ejemplos muestran el registro completo de Southwest Airlines en JSON y XML. Elija el formato de salida con response_type.

Respuesta · JSON

[
    {
        "airhex_id": "1046",
        "updated": "2026-09-08 12:31:16",
        "iata": "WN",
        "icao": "SWA",
        "parent_icao": null,
        "marketing_name": "Southwest Airlines",
        "full_name": "Southwest Airlines Co.",
        "status": "1",
        "type": "SCHEDULED",
        "type_code": "1",
        "alliance": null,
        "ffp_name": "Rapid Rewards",
        "lowcost": "1",
        "country_name": "United States",
        "country_code_alpha_2": "US",
        "country_code_alpha_3": "USA",
        "founded": "1967",
        "baggage_url": "https:\/\/support.southwest.com\/helpcenter\/pathway\/baggage",
        "colorscheme": [
            {
                "color": [
                    220,
                    28,
                    36
                ],
                "percent": 46,
                "hex": "#DC1C24",
                "dark": 1
            },
            {
                "color": [
                    44,
                    66,
                    153
                ],
                "percent": 22,
                "hex": "#2C4299",
                "dark": 1
            },
            {
                "color": [
                    203,
                    203,
                    203
                ],
                "percent": 21,
                "hex": "#CBCBCB",
                "dark": 0
            },
            {
                "color": [
                    251,
                    172,
                    28
                ],
                "percent": 9,
                "hex": "#FBAC1C",
                "dark": 0
            },
            {
                "color": [
                    43,
                    60,
                    132
                ],
                "percent": 2,
                "hex": "#2B3C84",
                "dark": 1
            }
        ],
        "website": "https:\/\/www.southwest.com",
        "web_checkin_url": "https:\/\/www.southwest.com\/air\/check-in\/?clk=HP-CHKIN",
        "mobile_checkin_url": "https:\/\/mobile.southwest.com\/check-in",
        "logo_rectangle": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_700_200_r.png?md5apikey=e742a162ae44192913f94cdc74895b32",
        "logo_square": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_200_200_s.png?md5apikey=cedfc6e88eba47799d33a91523f2a1b9",
        "logo_tail": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_200_200_t.png?md5apikey=8b855307bc1129996236f1fc65290f27",
        "logo_tail_flipped": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_200_200_f.png?md5apikey=33d73ff0ba4bae6f807732bcec857daa",
        "logo_rectangle_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_700_200_r.png?theme=dark&md5apikey=e742a162ae44192913f94cdc74895b32",
        "logo_square_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_200_200_s.png?theme=dark&md5apikey=cedfc6e88eba47799d33a91523f2a1b9",
        "logo_tail_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_200_200_t.png?theme=dark&md5apikey=8b855307bc1129996236f1fc65290f27",
        "logo_tail_flipped_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_200_200_f.png?theme=dark&md5apikey=33d73ff0ba4bae6f807732bcec857daa",
        "logo_rectangle_svg": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_r.svg?md5apikey=0a5c5b380650bd7c7cc5892cfe832ce6",
        "logo_square_svg": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_s.svg?md5apikey=285f91c093bda87be3fa08dfb79a481c",
        "logo_tail_svg": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_t.svg?md5apikey=f154888d47ecc664e5b45ed2fe9166c4",
        "logo_tail_flipped_svg": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_f.svg?md5apikey=cfd3053b5590deb50032556ebf1437c5",
        "logo_rectangle_svg_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_r.svg?theme=dark&md5apikey=0a5c5b380650bd7c7cc5892cfe832ce6",
        "logo_square_svg_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_s.svg?theme=dark&md5apikey=285f91c093bda87be3fa08dfb79a481c",
        "logo_tail_svg_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_t.svg?theme=dark&md5apikey=f154888d47ecc664e5b45ed2fe9166c4",
        "logo_tail_flipped_svg_dark": "https:\/\/content.airhex.com\/content\/logos\/airlines_WN_f.svg?theme=dark&md5apikey=cfd3053b5590deb50032556ebf1437c5"
    }
]

Respuesta · XML

<?xml version="1.0" encoding="UTF-8"?>
<airlines>
 <airline>
  <airhex_id>1046</airhex_id>
  <updated>2026-09-08 12:31:16</updated>
  <iata>WN</iata>
  <icao>SWA</icao>
  <parent_icao></parent_icao>
  <marketing_name>Southwest Airlines</marketing_name>
  <full_name>Southwest Airlines Co.</full_name>
  <status>1</status>
  <type>SCHEDULED</type>
  <type_code>1</type_code>
  <alliance></alliance>
  <ffp_name>Rapid Rewards</ffp_name>
  <lowcost>1</lowcost>
  <country_name>United States</country_name>
  <country_code_alpha_2>US</country_code_alpha_2>
  <country_code_alpha_3>USA</country_code_alpha_3>
  <founded>1967</founded>
  <baggage_url>https://support.southwest.com/helpcenter/pathway/baggage</baggage_url>
  <website>https://www.southwest.com</website>
  <web_checkin_url>https://www.southwest.com/air/check-in/?clk=HP-CHKIN</web_checkin_url>
  <mobile_checkin_url>https://mobile.southwest.com/check-in</mobile_checkin_url>
  <logo_rectangle>https://content.airhex.com/content/logos/airlines_WN_700_200_r.png?md5apikey=e742a162ae44192913f94cdc74895b32</logo_rectangle>
  <logo_square>https://content.airhex.com/content/logos/airlines_WN_200_200_s.png?md5apikey=cedfc6e88eba47799d33a91523f2a1b9</logo_square>
  <logo_tail>https://content.airhex.com/content/logos/airlines_WN_200_200_t.png?md5apikey=8b855307bc1129996236f1fc65290f27</logo_tail>
  <logo_tail_flipped>https://content.airhex.com/content/logos/airlines_WN_200_200_f.png?md5apikey=33d73ff0ba4bae6f807732bcec857daa</logo_tail_flipped>
  <logo_rectangle_dark>https://content.airhex.com/content/logos/airlines_WN_700_200_r.png?theme=dark&md5apikey=e742a162ae44192913f94cdc74895b32</logo_rectangle_dark>
  <logo_square_dark>https://content.airhex.com/content/logos/airlines_WN_200_200_s.png?theme=dark&md5apikey=cedfc6e88eba47799d33a91523f2a1b9</logo_square_dark>
  <logo_tail_dark>https://content.airhex.com/content/logos/airlines_WN_200_200_t.png?theme=dark&md5apikey=8b855307bc1129996236f1fc65290f27</logo_tail_dark>
  <logo_tail_flipped_dark>https://content.airhex.com/content/logos/airlines_WN_200_200_f.png?theme=dark&md5apikey=33d73ff0ba4bae6f807732bcec857daa</logo_tail_flipped_dark>
  <logo_rectangle_svg>https://content.airhex.com/content/logos/airlines_WN_r.svg?md5apikey=0a5c5b380650bd7c7cc5892cfe832ce6</logo_rectangle_svg>
  <logo_square_svg>https://content.airhex.com/content/logos/airlines_WN_s.svg?md5apikey=285f91c093bda87be3fa08dfb79a481c</logo_square_svg>
  <logo_tail_svg>https://content.airhex.com/content/logos/airlines_WN_t.svg?md5apikey=f154888d47ecc664e5b45ed2fe9166c4</logo_tail_svg>
  <logo_tail_flipped_svg>https://content.airhex.com/content/logos/airlines_WN_f.svg?md5apikey=cfd3053b5590deb50032556ebf1437c5</logo_tail_flipped_svg>
  <logo_rectangle_svg_dark>https://content.airhex.com/content/logos/airlines_WN_r.svg?theme=dark&md5apikey=0a5c5b380650bd7c7cc5892cfe832ce6</logo_rectangle_svg_dark>
  <logo_square_svg_dark>https://content.airhex.com/content/logos/airlines_WN_s.svg?theme=dark&md5apikey=285f91c093bda87be3fa08dfb79a481c</logo_square_svg_dark>
  <logo_tail_svg_dark>https://content.airhex.com/content/logos/airlines_WN_t.svg?theme=dark&md5apikey=f154888d47ecc664e5b45ed2fe9166c4</logo_tail_svg_dark>
  <logo_tail_flipped_svg_dark>https://content.airhex.com/content/logos/airlines_WN_f.svg?theme=dark&md5apikey=cfd3053b5590deb50032556ebf1437c5</logo_tail_flipped_svg_dark>
 </airline>
</airlines>

Tareas habituales de implementación

Descargar el directorio de aerolíneas

Exporte el directorio como CSV para su propia base de datos. Con onlyscheduled=0 se incluyen todos los tipos de aerolínea. Conserve airhex_id y updated al importar.

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

Resolver el identificador ICAO de una aerolínea

Use icao cuando su fuente de datos aporte un código ICAO de tres letras. Con el código IATA y el nombre devueltos, podrá vincular registros entre sus herramientas.

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

Buscar por nombre de aerolínea

La búsqueda por nombre admite coincidencias parciales. Compare los nombres y códigos de los resultados antes de elegir un registro.

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

Qué puede crear

Mostrar nombres de aerolínea reconocibles

Muestre nombres comerciales conocidos en lugar de razones sociales en los resultados de vuelos, las reservas y la información para pasajeros.

Facilitar la preparación del viaje

Incluya enlaces oficiales al check-in online y a la política de equipaje directamente en confirmaciones e itinerarios.

Mantener actualizado su directorio de aerolíneas

Mantenga coherentes la identidad, el estado y la clasificación de las aerolíneas en todas sus herramientas de viajes con datos de referencia que se actualizan con regularidad.

Preguntas frecuentes

¿La API devuelve nombres de aerolínea reconocibles o razones sociales?

Ambos. Use marketing_name para el nombre conocido por los viajeros, como Lufthansa, y full_name para la razón social registrada. Airhex mantiene estos nombres para que su equipo no tenga que convertir a mano las razones sociales de los directorios en nombres para mostrar.

¿Cómo mantengo actualizados los registros de aerolíneas?

Airhex revisa y actualiza los datos de aerolíneas a diario. Actualice su directorio local de forma periódica. La API de cambios ofrece un registro de cambios recientes: úselo para vigilar los cambios y obtener los registros actuales de la API de aerolíneas.

¿Puedo guardar el directorio en mi propia base de datos?

Sí, con una licencia adecuada de la base de datos de aerolíneas. Use dump=1 y elija JSON, XML o CSV. Conserve airhex_id como identificador permanente del registro y el campo updated, y programe actualizaciones periódicas de su copia local.

¿Qué aerolíneas devuelve la API por defecto?

El filtro predeterminado onlyscheduled=1 selecciona las aerolíneas regulares. Con onlyscheduled=0 se incluyen todos los tipos de aerolínea; en ese caso, revise status y type_code al aplicar sus propias reglas. El estado describe a la aerolínea: 1 = activa, 0 = inactiva, 2 = en fase de lanzamiento.

¿Puedo asociar las aerolíneas comercializadora y operadora de un proveedor de reservas?

Sí. Consulte cada código de aerolínea recibido por separado con iata o icao, según el sistema de códigos del proveedor. Su proveedor de vuelos determina qué aerolíneas comercializan y operan un vuelo; esta API ofrece los datos de referencia de esas aerolíneas.

¿Todas las aerolíneas tienen todos los campos de la respuesta?

No dé por hecho que cada registro incluye los dos códigos de aerolínea, una alianza, un programa de viajero frecuente o todos los enlaces de servicios al pasajero. Compruebe que haya valores antes de crear asociaciones o mostrar enlaces, y conserve el identificador original del proveedor como alternativa si una consulta no se puede resolver.

¿Cómo añado información de check-in y de equipaje a mis itinerarios?

Use web_checkin_url y baggage_url para llevar a los viajeros a los servicios oficiales de la aerolínea desde confirmaciones, e-tickets o pantallas de itinerario. Compruebe que cada URL tenga valor antes de mostrarla. La API ofrece enlaces; no hace el check-in de los pasajeros ni calcula el equipaje incluido ni los cargos de una reserva concreta.

¿Puedo filtrar las solicitudes por alianza, aerolínea low cost o estado de la aerolínea?

Esos valores son campos de la respuesta, no filtros de solicitud de este endpoint. Obtenga los registros que necesite o exporte el directorio y aplique esos filtros en su aplicación. Los parámetros de solicitud admitidos figuran más arriba.

¿Incluye tarifas, disponibilidad o estado de vuelos en tiempo real?

No. Este endpoint ofrece datos de referencia de aerolíneas. Para tarifas, disponibilidad, horarios y estado de cada vuelo, recurra a su proveedor de vuelos. El estado operativo de una aerolínea no describe el estado de un vuelo concreto.

¿Va a planificar la actualización? Ver la documentación de la API de cambios →

Integre datos actualizados de aerolíneas en su producto de viajes

Muestre nombres de aerolínea reconocibles y enlaces útiles de servicios al pasajero en la búsqueda, la reserva y el itinerario, mientras Airhex mantiene el directorio en el que se basan.

Clave de prueba de APISolicitar cotización →