API pays : base de données des pays et codes

Assurez la cohérence des informations sur les pays dans votre produit de voyage. Rapprochez les identifiants de pays des noms et des données géographiques, ou téléchargez le répertoire pour vos filtres de destinations, formulaires et rapports.

Clé d'API de testVoir l'exemple
  • Recherche par code alpha-2, alpha-3 et code ISO numérique
  • Consultation unitaire ou export complet
  • JSON, XML et CSV

Rechercher un pays par son code

Envoyez code2=US pour obtenir les États-Unis et leurs données de référence. Remplacez YOUR_API_KEY par votre clé d'API.

Description de l'endpoint

Cet endpoint renvoie les données d'un pays donné ou exporte toute la base de données des pays dans un fichier JSON, XML ou CSV.

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

Requête · cURL

curl --get 'https://content.airhex.com/api/v3.7.10/countries/' \
  --data-urlencode 'apikey=YOUR_API_KEY' \
  --data-urlencode 'code2=US'

Réponse · JSON

[
    {
        "airhex_id": "735",
        "updated": "2026-06-16 14:48:41",
        "iso": "840",
        "code2": "US",
        "code3": "USA",
        "name": "United States",
        "capital_code": "WAS",
        "currency_code": "USD",
        "region": "North America",
        "continent_code": "NA",
        "population": "310232863",
        "phone_code": "+1"
    }
]

Réponse JSON complète. Faites défiler le cadre pour voir tous les champs. Des exemples détaillés en JSON et en XML figurent plus bas.

Paramètres de la requête

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

Paramètre Obligatoire Valeur Type Par défaut Description
apikey Oui Tous String aucun Votre clé d'API. Obtenir une clé d'API de test gratuite.
code2 Conditionnel AA-ZZ String aucun Code pays à deux lettres selon ISO 3166-1 alpha-2
code3 Conditionnel AAA-ZZZ String aucun Code pays à trois lettres selon ISO 3166-1 alpha-3
iso Conditionnel Tous Int aucun Code pays numérique selon ISO 3166-1
name Conditionnel Tous String aucun Nom du pays ou partie du nom pour la recherche
dump Conditionnel 0 ou 1 Integer 0 Indiquez 1 pour exporter toute la base de données (ignore les autres paramètres conditionnels ci-dessus)
response_type Non JSON, XML ou CSV String JSON Format de la réponse : JSON, XML ou CSV (CSV lance le téléchargement d'un fichier)

Champs de la réponse

Obtenez dans un même enregistrement les identifiants de pays, les noms et les données géographiques de référence. Les champs documentés vous permettent de garder cohérents les rapprochements de pays dans vos systèmes.

Champ Exemple Description
airhex_id 735 Identifiant unique et permanent de l'enregistrement
updated 2026-06-16 14:48:41 Date et heure de la dernière mise à jour de l'enregistrement
iso 840 Code pays numérique selon ISO 3166-1
code2 US Code pays à deux lettres selon ISO 3166-1 alpha-2
code3 USA Code pays à trois lettres selon ISO 3166-1 alpha-3
name United States Nom du pays
capital_code WAS Code IATA à trois lettres de la capitale du pays
currency_code USD Code ISO de devise à trois lettres
region North America Région géographique du pays
continent_code NA Code de continent à deux lettres
population 310232863 Population du pays
phone_code +1 Indicatif téléphonique international du pays

Exemples de réponse complets

Ces exemples montrent l'enregistrement complet des États-Unis en JSON et en XML. Choisissez le format de sortie avec response_type.

Réponse · JSON

[
    {
        "airhex_id": "735",
        "updated": "2026-06-16 14:48:41",
        "iso": "840",
        "code2": "US",
        "code3": "USA",
        "name": "United States",
        "capital_code": "WAS",
        "currency_code": "USD",
        "region": "North America",
        "continent_code": "NA",
        "population": "310232863",
        "phone_code": "+1"
    }
]

Réponse · XML

<?xml version="1.0" encoding="UTF-8"?>
<countries>
 <country>
  <airhex_id>735</airhex_id>
  <updated>2026-06-16 14:48:41</updated>
  <iso>840</iso>
  <code2>US</code2>
  <code3>USA</code3>
  <name>United States</name>
  <capital_code>WAS</capital_code>
  <currency_code>USD</currency_code>
  <region>North America</region>
  <continent_code>NA</continent_code>
  <population>310232863</population>
  <phone_code>+1</phone_code>
 </country>
</countries>

Tâches d'intégration courantes

Télécharger le répertoire des pays

Exportez les pays en CSV pour vos formulaires et vos filtres de destinations locaux. Conservez airhex_id et updated lors de l'import.

curl --get 'https://content.airhex.com/api/v3.7.10/countries/' \
  --data-urlencode 'apikey=YOUR_API_KEY' \
  --data-urlencode 'dump=1' \
  --data-urlencode 'response_type=CSV' \
  --output countries.csv

Rapprocher un code pays à trois lettres

Utilisez code3 lorsqu'un fournisseur envoie des identifiants alpha-3, puis lisez la valeur code2 correspondante dans la réponse.

curl --get 'https://content.airhex.com/api/v3.7.10/countries/' \
  --data-urlencode 'apikey=YOUR_API_KEY' \
  --data-urlencode 'code3=USA'

Rechercher par nom de pays

Utilisez name pour chercher par le nom complet ou par une partie du nom. Vérifiez les identifiants renvoyés avant de retenir un résultat.

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

Ce que vous pouvez créer

Créer des sélecteurs de pays cohérents

Utilisez des noms de pays connus et des identifiants normalisés dans les formulaires et les filtres de destinations.

Ajouter un contexte utile sur la destination

Intégrez la devise et l'indicatif téléphonique dans les guides de pays et les écrans de préparation du voyage.

Relier les données géographiques de tout le produit

Rapprochez les pays des villes, des aéroports et des enregistrements fournisseurs pour filtrer et produire des rapports de façon cohérente.

Questions fréquentes

Quel est le lien entre les données des pays et celles des aéroports et des villes ?

Les API villes et aéroports renvoient country_code sous la forme d'un identifiant ISO à deux lettres. Rapprochez cette valeur de code2 dans l'API pays pour obtenir les noms de pays et d'autres données de référence. Conservez l'airhex_id de chaque enregistrement comme identifiant.

Quelles données de pays puis-je afficher dans mon produit de voyage ?

Outre les noms de pays et les identifiants ISO, la réponse inclut currency_code, phone_code, capital_code, region, continent_code et population. Utilisez-les pour le contexte de la destination et le regroupement géographique. Les codes de devise sont des valeurs de référence, pas des taux de change ; capital_code est un identifiant, pas un nom d'affichage.

Comment les données des pays sont-elles tenues à jour ?

Airhex regroupe des données géographiques issues de plusieurs sources, les vérifie et les contrôle chaque jour. Conservez airhex_id et updated, et mettez régulièrement à jour votre répertoire local. Le contrôle quotidien ne signifie pas que chaque champ de chaque pays change tous les jours.

Avec quels formats de code pays puis-je interroger l'API ?

Utilisez code2 pour les codes ISO alpha-2 à deux lettres, code3 pour les codes alpha-3 à trois lettres ou iso pour les codes pays numériques ISO. La réponse inclut les autres identifiants correspondants du pays.

Puis-je trouver un pays par son nom ?

Oui. Le paramètre name accepte les correspondances partielles. Comparez les noms et les codes de pays renvoyés avant de choisir un enregistrement.

Puis-je télécharger et stocker le répertoire des pays ?

Oui, avec une licence adaptée de GEO Essentials. Définissez dump=1 et choisissez JSON, XML ou CSV avec response_type. Conservez airhex_id et updated, et mettez régulièrement à jour votre copie locale.

Cette API fournit-elle les conditions de visa ou d'entrée ?

Non. Elle fournit des données de référence sur les pays. Pour connaître les règles de visa en vigueur, les conditions d'entrée et les restrictions de voyage, adressez-vous à un spécialiste compétent ou à une source officielle.

Des informations de pays cohérentes pour chaque voyage

Reliez vos filtres de destinations, vos formulaires voyageurs et vos guides de pays à des codes pays à jour et à des données de destinations utiles.

Clé d'API de testDemander un devis →