API paesi: database dei paesi e codici

Mantieni coerenti le informazioni sui paesi nel tuo prodotto di viaggio. Associa gli identificatori dei paesi a nomi e dati geografici oppure scarica l’elenco per filtri di destinazione, moduli e report.

Chiave API di provaVedi l’esempio
  • Ricerca per codice alfa-2, alfa-3 e ISO numerico
  • Consultazione singola o esportazione completa
  • JSON, XML e CSV

Cerca un paese tramite il suo codice

Invia code2=US per ottenere gli Stati Uniti e i loro dati di riferimento. Sostituisci YOUR_API_KEY con la tua chiave API.

Descrizione dell’endpoint

Questo endpoint restituisce i dettagli di un paese specifico oppure esporta l’intero database dei paesi in un file JSON, XML o CSV.

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

Richiesta · cURL

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

Risposta · 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"
    }
]

Risposta JSON completa. Scorri all’interno del riquadro per vedere tutti i campi. Più sotto trovi esempi estesi in JSON e XML.

Parametri della richiesta

Indica almeno uno tra code2, code3, iso, name o dump=1. Con dump=1 gli altri parametri di ricerca vengono ignorati.

Parametro Obbligatorio Valore Tipo Predefinito Descrizione
apikey Sì Qualsiasi String Nessuno La tua chiave API. Richiedi una chiave API di prova gratuita.
code2 Condizionale AA-ZZ String Nessuno Codice paese ISO 3166-1 alfa-2 a due lettere
code3 Condizionale AAA-ZZZ String Nessuno Codice paese ISO 3166-1 alfa-3 a tre lettere
iso Condizionale Qualsiasi Int Nessuno Codice paese numerico ISO 3166-1
name Condizionale Qualsiasi String Nessuno Nome del paese o parte del nome per la ricerca
dump Condizionale 0 o 1 Integer 0 Imposta 1 per esportare l’intero database (ignora gli altri parametri condizionali indicati sopra)
response_type No JSON, XML o CSV String JSON Formato della risposta: JSON, XML o CSV (con CSV parte il download di un file)

Campi della risposta

Ottieni dallo stesso record identificatori dei paesi, nomi e dati geografici di riferimento. Con i campi documentati mantieni coerenti le associazioni dei paesi in tutti i tuoi sistemi.

Campo Esempio Descrizione
airhex_id 735 Identificatore univoco e permanente del record
updated 2026-06-16 14:48:41 Data e ora dell’ultimo aggiornamento del record
iso 840 Codice paese numerico ISO 3166-1
code2 US Codice paese ISO 3166-1 alfa-2 a due lettere
code3 USA Codice paese ISO 3166-1 alfa-3 a tre lettere
name United States Nome del paese
capital_code WAS Codice IATA a tre lettere della capitale del paese
currency_code USD Codice valuta ISO a tre lettere
region North America Regione geografica del paese
continent_code NA Codice del continente a due lettere
population 310232863 Numero di abitanti del paese
phone_code +1 Prefisso telefonico internazionale del paese

Esempi di risposta completi

Gli esempi mostrano il record completo degli Stati Uniti in JSON e XML. Scegli il formato di output con response_type.

Risposta · 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"
    }
]

Risposta · 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>

Attività comuni di implementazione

Scarica il tuo elenco dei paesi

Esporta i paesi in CSV per i tuoi moduli e filtri di destinazione locali. Conserva airhex_id e updated quando importi i record.

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

Associa un codice paese a tre lettere

Usa code3 quando un fornitore invia identificatori alfa-3, poi leggi dalla risposta il valore code2 corrispondente.

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

Cerca per nome del paese

Usa name per cercare per nome completo o parziale. Controlla gli identificatori restituiti prima di scegliere un risultato.

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

Cosa puoi creare

Crea selettori di paesi coerenti

Usa nomi di paesi riconoscibili e identificatori standardizzati in moduli e filtri di destinazione.

Aggiungi un contesto utile sulla destinazione

Inserisci valuta e prefisso telefonico nelle guide dei paesi e nelle schermate di pianificazione del viaggio.

Collega i dati geografici in tutto il prodotto

Associa i paesi ai record di città, aeroporti e fornitori per filtrare e creare report in modo coerente.

Domande frequenti

Come si collegano i dati dei paesi a quelli di aeroporti e città?

Le API città e aeroporti restituiscono country_code come identificatore ISO a due lettere. Associa questo valore a code2 nell’API paesi per ottenere i nomi dei paesi e altri dati di riferimento. Conserva l’airhex_id di ciascun record come identificativo.

Quali dati dei paesi posso mostrare nel mio prodotto di viaggio?

Oltre ai nomi dei paesi e agli identificatori ISO, la risposta include currency_code, phone_code, capital_code, region, continent_code e population. Usali per il contesto della destinazione e per il raggruppamento geografico. I codici valuta sono valori di riferimento, non tassi di cambio; capital_code è un identificatore, non un nome da visualizzare.

Come vengono mantenuti aggiornati i dati dei paesi?

Airhex raccoglie e verifica dati geografici da più fonti e li controlla ogni giorno. Conserva airhex_id e updated e aggiorna periodicamente il tuo elenco locale. Il controllo quotidiano non significa che ogni campo di ogni paese cambi ogni giorno.

Con quali formati di codice paese posso fare una ricerca?

Usa code2 per i codici ISO alfa-2 a due lettere, code3 per i codici alfa-3 a tre lettere o iso per i codici numerici ISO dei paesi. La risposta include gli altri identificatori corrispondenti del paese.

Posso trovare un paese dal nome?

Sì. Il parametro name supporta la corrispondenza parziale. Confronta i nomi e i codici dei paesi restituiti prima di scegliere un record.

Posso scaricare e salvare l’elenco dei paesi?

Sì, con una licenza GEO Essentials adeguata. Imposta dump=1 e scegli JSON, XML o CSV con response_type. Conserva airhex_id e updated e aggiorna periodicamente la tua copia locale.

Questa API fornisce i requisiti di visto o di ingresso?

No. Fornisce dati di riferimento sui paesi. Per le norme sui visti, i requisiti di ingresso e le restrizioni di viaggio in vigore, rivolgiti a uno specialista o a una fonte ufficiale.

Porta informazioni coerenti sui paesi in ogni fase del viaggio

Collega filtri di destinazione, moduli per i viaggiatori e guide dei paesi a codici paese aggiornati e a dati utili sulle destinazioni.

Chiave API di provaRichiedi un preventivo →