Exigence de visa
Ce endpoint donne accès à plusieurs informations :
- Détails sur le pays de la nationalité et sur celui de destination permettant de composer une phrase pour un affichage sur votre site internet ou application.
- Information sur l’exigence ou non d’un visa ou d’un document de voyage.
- Liste des visas possibles et des documents nécessaires pour leurs obtentions.
Requête
GET https://connect.visamundi.io/v3/partner/{name}/requirements
Dans cette requête, {name} doit être remplacé par votre identifiant. Celui-ci, en association avec votre clé API, vous permettra d’obtenir les informations souhaités.
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 la clé API |
language | Optionnel | En savoir plus sur les langues disponibles |
nationality | Requis | Code à 2 ou 3 caractères suivant la norme ISO 3166-1. En savoir plus |
destination | Requis | Code à 2 ou 3 caractères suivant la norme ISO 3166-1. En savoir plus |
Exemple de réponse
{
"success": true,
"statusCode": 200,
"code": "ok",
"data": {
"nationality": {
"name": {
"common": "France",
"official": "République française"
},
"cca2": "FR",
"cca3": "FRA",
"demonyms": {
"singular": {
"f": "Française",
"m": "Français"
},
"plural": {
"f": "Françaises",
"m": "Français"
}
}
},
"destination": {
"name": {
"common": "Inde",
"official": "République de l'Inde"
},
"cca2": "IN",
"cca3": "IND",
"demonyms": {
"singular": {
"f": "Indienne",
"m": "Indien"
},
"plural": {
"f": "Indiennes",
"m": "Indiens"
}
},
"url": {
"destination": "https://www.visamundi.co/destinations/inde/",
"form": "https://form.visamundi.app/apply/in/"
}
},
"requirement": "e-visa",
"visas": [
{
"name": "e-Visa Business",
"reasons": {
"business": "Affaires / Business"
},
"stay_duration": 180,
"validity_duration": 365,
"documents": [
{
"name": "Passeport",
"specificity": "valide au moins 6 mois"
},
{
"name": "Photo d'identité",
"specificity": ""
},
{
"name": "Carte de visite",
"specificity": ""
},
{
"name": "Lettre d'invitation",
"specificity": ""
}
]
},
...
]
}
}
Paramètres de réponse
Dans la réponse, data
contient plusieurs objets et éléments :
Paramètre/Objet | Description |
---|---|
nationality | Objet Pays (en version simplifiée). |
destination | Objet Pays (en version simplifiée). Cet objet contient également une propriété url :– 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 |
requirement | Exigence ou non de visa ou de document de voyage. |
visas | Tableau d’objets contenant les visas disponibles pour la paire nationalité/destination. – Clé name Nom du visa.– Clé reasons Raisons de voyage liés à ce visa.– Clé stay_duration Durée maximal de séjour dans le pays de destination (En jours).– Clé validity_duration Durée de validité du visa (En jours).– Clé documents Tableau des documents requis pour l’obtention du visa/document de voyage.Objet document : – Clé name Nom du document.– Clé specificity Spécificités à prendre en compte vis-à-vis du document en question. |
Précisions sur l’exigence de visa/document de voyage
Valeurs possibles du paramètre requirement
renvoyé avec la réponse de ce endpoint :
Valeur | Explication |
---|---|
7 – 365 | Nombre de jours sans visa, si disponible. |
visa free | Voyage sans visa (lorsque le nombre de jours est inconnu ou non applicable, comme la liberté de mouvement), y compris l’obligation d’enregistrement touristique pour les Seychelles. |
visa on arrival | Destination qui accorde un visa à l’arrivée, essentiellement sans visa. |
e-visa | Un document de voyage ou visa électronique est requis. |
visa required | L’obtention d’un visa est obligatoire pour voyager. Comprend les cartes touristiques de Cuba. |
no admission | Comprend des situations rares, telles que des guerres. |
-1 | Quand nationality = destination . |
no data | Aucune donnée disponible. |
Codes et messages d’erreur
En plus des codes et messages d’erreur de l’API, ce endpoint peut renvoyer certains autres codes et messages :
StatusCode | Code | Description |
---|---|---|
200 | no_country_found | « No country found » La requête s’est bien déroulée mais les pays passés avec les paramètres nationality ou destination n’ont pas été trouvé. |
400 | required_parameters_error | « Missing or incorrect required parameters » Les paramètres nationality ou destination n’ont pas été envoyés avec la requête ou ne respectent pas le format attendu. |
403 | country_restrictions | « Your account has a restriction on this country » Votre compte possède une restriction et ne peut afficher que les contenus de certains pays. |
403 | forbidden | « Partner ID and API key do not match » Le paramètre {name} dans l’url du endpoint ne correspond pas à la clé d’authentification. |