API couleurs de marque des compagnies aériennes

Apportez les couleurs des compagnies à l'expérience de voyage. Obtenez les couleurs de marque associées aux noms et aux codes des compagnies, avec des valeurs hexadécimales et RVB pour les cartes de vol, les itinéraires et les profils de compagnies.

Clé d'API de test Voir l'exemple
  • Valeurs de couleur hexadécimales et RVB
  • Recherche par code ou par nom
  • Métadonnées de la palette de couleurs

Obtenir les couleurs de marque d'une compagnie aérienne

Interrogez United Airlines avec le code IATA UA et lisez le tableau colorscheme. Chaque entrée de la palette comprend des valeurs RVB, une valeur hexadécimale, un pourcentage et un indicateur de teinte sombre. Remplacez YOUR_API_KEY par votre clé d'API.

Requête · cURL

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

Réponse · extrait JSON

[
  {
    "iata": "UA",
    "icao": "UAL",
    "marketing_name": "United Airlines",
    "colorscheme": [
      {
        "color": [20, 20, 212],
        "percent": 98,
        "hex": "#1414D4",
        "dark": 1
      }
    ],
    ...
  }
]

Réponse abrégée. Les points de suspension (…) représentent d'autres champs de la compagnie omis ici, qui ne font pas partie de la réponse JSON réelle.

Voir la référence complète : API compagnies aériennes →

Paramètres de la requête

Interrogez une compagnie ou exportez le répertoire, puis lisez colorscheme dans les enregistrements renvoyés. colorscheme est un champ de la réponse et non un paramètre de requête. En JSON, vous travaillez directement avec les entrées imbriquées de la palette.

ParamètreObligatoirePar défautDescription
apikey OuiAucunVotre clé d'API. Obtenir une clé d'API de test gratuite.
iata ConditionnelAucunRecherche d'une compagnie par son code IATA à deux caractères, par exemple UA.
icao ConditionnelAucunRecherche d'une compagnie par son code OACI à trois lettres, par exemple UAL.
name ConditionnelAucunRecherche de codes de compagnies par nom complet ou partiel de la compagnie.
dump Conditionnel0Avec 1, exporte le jeu de données complet, selon le filtre onlyscheduled.
response_type NonJSONFormat de la réponse : JSON, XML ou CSV. CSV lance le téléchargement d'un fichier.
onlyscheduled Non1Avec 1, seules les compagnies régulières sont renvoyées ; avec 0, tous les types de compagnies.

Indiquez au moins l'un des paramètres iata, icao, name ou dump=1. Avec dump=1, les autres paramètres de recherche sont ignorés.

Voir tous les paramètres de la requête →

Données disponibles

Choisissez des touches de couleur avec colorscheme et l'identifiant de la compagnie. Les lignes suivantes décrivent le tableau de la palette et ses propriétés imbriquées ; stockez le tableau complet lorsque vous enregistrez la réponse.

ChampTypeExempleDescription
airhex_id String965Identifiant permanent de l'enregistrement chez Airhex. Utilisez-le pour rattacher les futures mises à jour au même enregistrement.
iata StringUACode IATA à deux caractères de la compagnie. Les codes peuvent contenir des lettres et des chiffres ; stockez-les sous forme de texte.
icao StringUALCode OACI à trois lettres de la compagnie, utile pour passer d'un système de codes à un autre.
marketing_name StringUnited AirlinesNom commercial de la compagnie à afficher dans votre application.
colorscheme ArrayVoir l'exemple JSONCouleurs de marque de la compagnie avec valeurs RVB, pourcentage, valeur hexadécimale et indicateur de teinte sombre.
colorscheme[].color Array[20, 20, 212]Composantes RVB de cette entrée de la palette, dans l'ordre rouge, vert, bleu.
colorscheme[].percent Number98Pourcentage fourni avec cette entrée de la palette ; ce n'est pas une répartition de surface recommandée pour votre interface.
colorscheme[].hex String#1414D4Valeur de couleur hexadécimale de cette entrée de la palette.
colorscheme[].dark Integer1Indicateur de luminosité fourni avec cette entrée ; ce n'est pas un rapport de contraste mesuré pour du texte.

Voir toutes les données disponibles →

Tâches d'intégration courantes

Télécharger les palettes des compagnies pour votre application

Exportez le répertoire en JSON pour obtenir chaque tableau colorscheme avec ses propriétés imbriquées. Stockez les palettes avec les noms des compagnies, les codes et airhex_id. Définissez onlyscheduled=0 si vous avez besoin de types de compagnies autres que régulières, et choisissez les enregistrements adaptés dans votre application.

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=JSON' \
  --output airline-brand-colors.json

Trouver les couleurs de marque par nom de compagnie

Cherchez avec name, confirmez la compagnie voulue et lisez colorscheme. La recherche par nom accepte les correspondances partielles. Examinez la compagnie renvoyée avant d'appliquer une palette à une carte ou à un profil de compagnie.

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

Obtenir la palette de couleurs avec un code OACI

Utilisez icao lorsque votre source de données fournit un code de compagnie à trois lettres. L'exemple interroge United Airlines avec UAL et renvoie colorscheme avec l'identifiant de la compagnie.

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

Ce que vous pouvez créer

Touches de couleur des compagnies dans les résultats de vols

Utilisez les couleurs des compagnies pour les bordures de cartes, les badges ou d'autres touches de couleur, en gardant les prix et les informations de vol lisibles.

Profils de compagnies cohérents

Utilisez la même palette stockée dans les profils de compagnies, les itinéraires et les pages de comparaison.

Tableaux de bord aux couleurs reconnaissables

Associez les séries des graphiques et les légendes aux couleurs des compagnies, et ajoutez des libellés textuels qui nomment chaque compagnie.

Questions fréquentes

Que renvoie l'API couleurs de marque des compagnies aériennes ?

Le champ colorscheme contient un tableau d'entrées de palette. Chaque entrée comprend color avec les composantes RVB, hex avec la valeur hexadécimale, percent avec le pourcentage fourni et dark comme indicateur de teinte sombre.

Puis-je utiliser en CSS les valeurs hexadécimales renvoyées ?

Oui. Une valeur hexadécimale renvoyée, comme #1414D4, peut servir de couleur CSS. Vérifiez que la palette et la valeur existent avant de les appliquer, et prévoyez une couleur par défaut pour les données manquantes. Les composantes RVB sont dans color. Affichez le nom et le logo de la compagnie pour que les voyageurs n'aient pas à la reconnaître uniquement à sa couleur.

L'API renvoie-t-elle une seule couleur principale ou plusieurs ?

La réponse est un tableau. Votre intégration doit donc accepter plusieurs entrées et ne pas supposer une couleur unique. Choisissez l'entrée à afficher selon les besoins de votre interface ; toutes les compagnies n'ont pas le même nombre d'entrées dans leur palette.

percent doit-il déterminer la place d'une couleur dans mon interface ?

Non. La valeur est une métadonnée de l'entrée de la palette, et non une consigne de conception de page. C'est votre système de design qui décide où et dans quelle mesure chaque couleur est utilisée.

dark garantit-il un texte blanc ou noir lisible ?

Non. Considérez dark comme un indicateur de teinte sombre, et non comme un contrôle d'accessibilité ou un rapport de contraste. Vérifiez la combinaison précise de couleur de texte et de fond dans votre interface.

La palette remplace-t-elle la charte graphique d'une compagnie ?

Non. Le champ fournit des données de couleur, et non une charte graphique complète, des spécifications de couleurs d'impression ni une autorisation d'utiliser les marques d'une compagnie. Si vous avez besoin d'exigences de marque précises, consultez la charte graphique correspondante.

Que faire si colorscheme est absent ou vide ?

Utilisez le style par défaut de votre application et laissez visible le nom de la compagnie. Ne déduisez pas une palette de l'alliance ni de la compagnie mère.

Puis-je télécharger les couleurs des compagnies et les stocker en local ?

Oui, avec une licence adaptée de la base de données des compagnies aériennes. Exportez avec dump=1 et response_type=JSON pour obtenir la structure imbriquée de la palette. Conservez l'identifiant de la compagnie avec chaque palette et mettez régulièrement à jour les enregistrements stockés. Conservez airhex_id et l'horodatage updated de la réponse complète pour détecter les changements de palette.

Rendez les compagnies plus reconnaissables dans votre produit

Apportez des touches de couleur cohérentes des compagnies aux résultats de vols, aux profils et aux informations passagers, sans rechercher à la main la palette de chaque compagnie.

Clé d'API de testDemander un devis →

API compagnies aériennes →

Explorez le jeu de données complet des compagnies aériennes : codes IATA et OACI, noms, statut opérationnel, types de compagnies, alliances, programmes de fidélité, liens vers l'enregistrement en ligne et la politique de bagages, logos et couleurs de marque. Tous les paramètres de requête et champs de réponse, avec consultations unitaires et export complet en JSON, XML et CSV.

API alliances aériennes →

Consultez l'alliance d'une compagnie aérienne par code IATA, code OACI ou nom, créez des filtres par alliance et regroupez les compagnies dans votre application.

API programmes de fidélité →

Consultez le programme de fidélité des compagnies par code IATA, code OACI ou nom, créez des répertoires de programmes et enrichissez vos profils de compagnies.