Données d’un pays

Ce endpoint renvoi les données disponibles sur un pays (noms, codes, gentilés, devises, langues, pays frontaliers, etc).

Requête

GET  https://connect.visamundi.io/v3/country/{id}

Dans cette requête, {id} doit être remplacé par un code pays suivant la norme ISO 3166-1 (Vous pouvez utiliser les codes à 2 ou 3 lettres).

Exemple :

GET  https://connect.visamundi.io/v3/country/FRA

Paramètres de la requête

Paramètre		Description
access_token	Requis	La clé permettant de vous authentifier auprès de l’API. En savoir plus sur l’authentification
language	Optionnel	En savoir plus sur les langues disponibles

Exemple de réponse

{
    "success": true,
    "statusCode": 200,
    "code": "ok",
    "data": {
        "country": {
            "name": {
                "common": "France",
                "official": "République française"
            },
            "cca2": "FR",
            "cca3": "FRA",
            "ccn3": "250",
            "flag": "🇫🇷",
            "slug": "france",
            "demonyms": {
                "singular": {
                    "f": "Française",
                    "m": "Français"
                },
                "plural": {
                    "f": "Françaises",
                    "m": "Français"
                }
            },
            "currencies": {
                "EUR": {
                    "name": "Euro",
                    "symbol": "€"
                }
            },
            "languages": {
                "fra": "Français"
            },
            "capital": [
                "Paris"
            ],
            "continent": "Europe",
            "hpi": 13,
            "latlng": [
                46.2276001,
                2.21374989
            ],
            "independant": true,
            "status": "officially-assigned",
            "un_member": true,
            "landlocked": false,
            "borders": [
                "DEU",
                "AND",
                "BEL",
                "ESP",
                "ITA",
                "LUX",
                "MCO",
                "CHE"
            ],
            "url": {
                "destination": "https://www.visamundi.co/destinations/inde/",
                "form": "https://form.visamundi.app/apply/in/",
                "official": "https://indianvisaonline.gov.in/"
            }
        }
    }
}

Paramètres de réponse

Dans la réponse, data contient un objet country avec plusieurs éléments :

Paramètre/Objet	Description
name	Objet contenant le nom commun (common) du pays ainsi que son nom officiel (official).
cca2	Code pays à 2 lettres basé sur la norme ISO 3166-1. En savoir plus sur les codes pays
cca3	Code pays à 3 lettres basé sur la norme ISO 3166-1. En savoir plus sur les codes pays
ccn3	Code pays numérique basé sur la norme ISO 3166-1.
flag	Drapeau Emoji
slug	Slug basé sur le nom commun du pays.
demonyms	Nom donné aux habitants (au singulier et au pluriel). Clé : f (féminin) ou m (masculin). Valeur : nom donné selon le genre.
currencies	Objet contenant les devises utilisées dans le pays. Clé : Code à 3 lettres selon la norme ISO 4217. Valeur : Objet détaillant la devise – Clé name Nom de la monnaie. – Clé symbol Symbole de la monnaie.
languages	Objet contenant les langues parlées dans le pays. Clé : Code à 3 lettres de la langue selon la norme ISO 639-3. Valeur : Le nom de la langue.
capital	Tableau contenant les différentes capitales du pays.
continent	Nom du continent.
hpi	Position dans le classement Henley des passeports (Henley Passport Index).
latlng	Tableau contenant la latitude et la longitude du centre du pays.
independant	Booléen indiquant si le pays est considéré comme un État souverain.
status	Statut du pays selon la norme ISO 3166-1.
un_member	Booléen indiquant si le pays est membre des Nations Unis.
landlocked	Booléen indiquant si le pays est enclavé.
borders	Codes des pays frontaliers. En savoir plus sur les codes pays
url	Objet contenant différentes urls liées à Visamundi : – Clé destination Url de la page dédiée à la destination sur le site Visamundi. – Clé form Url du formulaire de demande de visa pour cette destination. – Clé official Url du site officiel des autorités (Note : Ces urls peuvent être des chaînes vides si aucune ressource n’existe)

Codes et messages d’erreur

En plus des codes et messages d’erreur de l’API, ce endpoint peut renvoyer d’autres codes et messages :

StatusCode	Code	Description
200	no_country_found	« No country found » La requête s’est bien déroulée mais aucun pays n’a été trouvé.