ForHosting KIT · Voyages et géographie

Exigence de visa

Avec un passeport américain, le Mexique dispense de visa pour un séjour jusqu'à 180 jours, selon une petite table fixe de 25 paires de pays. Saisissez les codes à deux lettres du passeport et de la destination pour voir l'un des trois statuts de visa. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Pays du passeport: US
Pays de destination: MX

Vous obtenez

Clé de la paire: US>MX
Statut du visa: visa_free
Libellé du statut: Visa-free
Taille de la table: 25

Planifier un voyage international commence presque toujours par la même question pratique : votre passeport a-t-il besoin d'un visa pour cette destination ? Les ambassades publient de longues pages, les blogs divergent entre e-visa et tampon à l'arrivée, et les équipes produit ont encore besoin d'une réponse déterministe pour les démos, l'intégration et les tests de non-régression. Cette vérification d'exigence de visa accepte le pays du passeport du voyageur et le pays de destination sous forme de codes ISO 3166-1 alpha-2, recherche la paire ordonnée dans une table de référence fixe intégrée et renvoie l'un de trois statuts clairs : visa obligatoire avant le départ, visa à l'arrivée ou entrée sans visa. Il s'agit de données éducatives et faciles à intégrer—pas d'un conseil d'ambassade en direct—, aussi devez-vous toujours vérifier les itinéraires critiques auprès de sources officielles avant le départ.

Signification des valeurs de statut de visa et fonctionnement de la recherche

Cette capacité répond à une question étroite et à forte valeur : pour un pays émetteur de passeport et un pays de destination donnés, que dit la table de référence stub sur les formalités d'entrée ? Trois résultats sont pris en charge.

Visa required signifie que le voyageur doit obtenir un visa (ou une autorisation électronique approuvée traitée comme un visa préalable) avant l'embarquement ou le contrôle frontalier ; la réponse n'invente ni URL de consulats ni formulaires, elle étiquette seulement le statut pour que votre produit puisse orienter l'utilisateur vers l'étape suivante.

Visa on arrival signifie que la table enregistre qu'un visa ou une permission équivalente peut être accordé au point d'entrée selon les règles du stub, souvent avec une durée maximale de séjour en jours lorsque la ligne inclut ce détail. Visa-free signifie que la table enregistre qu'une entrée de court séjour n'exige pas de demande de visa séparée pour ce passeport et cette destination dans les données du stub.

L'algorithme est volontairement simple et déterministe : normaliser les deux champs pays en codes ISO 3166-1 alpha-2 de deux lettres en majuscules, rejeter les codes mal formés et les paires d'un même pays, construire une clé de paire de la forme PASSPORT greater-than DESTINATION, puis interroger une table de hachage en mémoire.

Quand une vérification rapide du visa aide

Les places de marché du voyage et les bacs à sable de réservation ont besoin d'un signal fiable pour afficher des badges de visa obligatoire avant l'abandon du panier, mais les flux gouvernementaux en direct sont instables, limités en débit ou sous licence. Un stub de niveau parse avec table fixe permet aux équipes produit de livrer le parcours UX, d'écrire des tests de bout en bout et de former le support sur trois statuts discrets sans dépendre du réseau.

Les plateformes d'éducation et d'examen qui enseignent la réglementation touristique peuvent interroger les apprenants sur les codes pays ISO et cartographier les statuts sans gratter Wikipedia. Les outils internes qui normalisent les enregistrements de nom de passager ont souvent besoin d'un contrôle secondaire bon marché : étant donné le pays d'émission du passeport et la destination de l'itinéraire, attacher un indicateur stub pour revue opérationnelle. Une validation échouée ne consomme pas de solde.

Cas d’usage

Badges de visa à la réservation et au paiement

Affichez des libellés sans visa, visa à l'arrivée ou visa obligatoire sur les résumés de voyage lorsque la paire passeport du passager et destination existe dans la table stub.

Questions fréquentes

Que se passe-t-il si la paire de pays n'est pas dans la table de référence ?

Le stub n'invente jamais de politique de visa pour des combinaisons passeport–destination inconnues, et la validation échouée n'est pas facturée.

S'agit-il d'un conseil officiel de visa en direct ?

Non. Il s'agit d'une table de référence stub déterministe pour démos produit, tests et recherches éducatives. Confirmez toujours les règles d'entrée auprès des ambassades ou des sources gouvernementales officielles avant de voyager.

Quel format de code pays est accepté ?

Uniquement des codes ISO 3166-1 alpha-2 de deux lettres, insensibles à la casse (US, us et Us se normalisent en US). Les codes à trois lettres, les noms comme Mexico et les paires d'un même pays sont rejetés.

Que signifient les trois statuts de visa ?

Visa obligatoire signifie obtenir un visa ou une autorisation électronique approuvée avant le voyage. Visa à l'arrivée indique que l'autorisation peut être délivrée à la frontière. Dispense de visa indique un court séjour sans demande séparée.

Le résultat indique-t-il la durée de séjour autorisée ?

Seulement quand la ligne de la table comporte une durée maximale. Pour un passeport américain à destination du Mexique, elle affiche jusqu'à 180 jours ; pour les paires sans cette donnée, aucune limite n'est indiquée.

Outils associés

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

POSThttps://api.kit.forhosting.com/travel/visa-required-check-stub

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/travel/visa-required-check-stub \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"passport_country":"US","destination_country":"MX"}'

const res = await fetch("https://api.kit.forhosting.com/travel/visa-required-check-stub", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "passport_country": "US",
    "destination_country": "MX"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/travel/visa-required-check-stub",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "passport_country": "US",
    "destination_country": "MX"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/travel/visa-required-check-stub", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"passport_country":"US","destination_country":"MX"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"passport_country":"US","destination_country":"MX"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/travel/visa-required-check-stub", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "passport_country": "US",
  "destination_country": "MX"
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "travel.visa_required_check_stub",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Notes techniques

Lorsque la paire est absente de la table, l'appel échoue avec invalid_input au lieu d'inventer une règle.

Signification des valeurs de statut de visa et fonctionnement de la recherche

Un succès renvoie visa_status, un status_label lisible, max_stay_days optionnel lorsqu'il est connu, notes et des métadonnées telles que table_size et method. Un échec lève invalid_input en nommant la paire manquante. Souvenez-vous que la politique réelle de visa change selon la nationalité, le motif du voyage, les refus antérieurs et les accords bilatéraux ; ce stub fige un petit ensemble éducatif pour que les équipes d'ingénierie branchent l'UX et la facturation sans gratter le web ni appeler des API de visa payantes pendant le développement.

Contrat d'entrée, forme de la réponse et comportement d'erreur

Les charges utiles numériques ou objets pour ces champs sont rejetées. Si les deux codes sont valides mais identiques, le gestionnaire rejette la requête car le voyage intérieur sort du périmètre d'une recherche de visa transfrontalière. Si les deux codes sont valides et différents mais que la paire ordonnée est absente de la table de référence intégrée, la tâche échoue avec un message clair indiquant que la paire de pays n'est pas dans la table de référence—ces échecs ne sont pas facturés. Associez la réponse à vos propres formulaires d'éligibilité, capture photo de passeport ou liens profonds d'ambassade si vous avez besoin d'un entonnoir de demande complet ; ce point de terminaison classe seulement la paire par rapport à la table de référence et ne traite pas de demandes, ne collecte pas de biométrie et ne consulte pas de listes de surveillance. Envoyez un corps JSON en POST avec deux champs chaîne obligatoires : passport_country et destination_country. Chaque valeur doit être un code pays ISO 3166-1 alpha-2 de deux lettres ; la casse est ignorée, les espaces latéraux sont coupés, et tout ce qui n'est pas exactement deux lettres latines après normalisation échoue avec invalid_input en nommant le champ. En cas de succès, le corps renvoie passport_country et destination_country normalisés, le pair_key utilisé pour la recherche, visa_status parmi visa_required, visa_on_arrival ou visa_free, un status_label adapté à l'interface, notes décrivant la ligne du stub, in_reference_table à true, method à stub_reference_table_lookup, et table_size égal au nombre de paires actuellement livrées. Lorsque la ligne inclut une durée maximale de séjour positive, max_stay_days est présent en entier ; lorsque le stub ne définit pas de limite pour cette paire, le champ est entièrement omis plutôt que renvoyé en null, conformément au contrat du moteur de rendu pour les sorties optionnelles. Exemple : passport_country US et destination_country MX produisent visa_free avec un max_stay_days de plusieurs mois dans la table stub. Exemple : passport_country US et destination_country CN produisent visa_required sans max_stay_days.

Où une API stub d'exigence de visa apporte de la valeur

Comme l'implémentation est un parse pur de niveau A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle et sans réseau sortant. Cette combinaison fournit des valeurs visa_status reproductibles pour les démos, plugins LMS et edge workers sans dresser un pipeline de données géopolitiques de votre côté.

Cas d'intégration

QA et régression golden pour l'UX voyage

Pilotez des tests déterministes des flux d'intégration voyage avec des paires ISO fixes au lieu de scrapers d'ambassade instables en direct.

Widgets éducatifs et de contenu

Laissez apprenants et lecteurs consulter des statuts d'exemple passeport–destination dans le navigateur avec la même logique que l'API facture à $0.002.

Questions techniques

Comment vérifier si un visa est requis pour ma destination ?

Envoyez passport_country et destination_country sous forme de codes ISO 3166-1 alpha-2 (par exemple US et MX). L'API renvoie visa_status parmi visa_required, visa_on_arrival ou visa_free lorsque la paire est dans la table de référence.

Combien coûte la vérification d'exigence de visa ?

L'outil navigateur est gratuit. Les requêtes API utilisent le solde prépayé KIT à $0.002 par appel réussi ; une entrée invalide n'est pas facturée.

Consulter la documentation complète du KIT →

Lancer gratuitement

Exemple résolu

Signification des valeurs de statut de visa et fonctionnement de la recherche

Quand une vérification rapide du visa aide

Cas d’usage

Badges de visa à la réservation et au paiement

Questions fréquentes

Outils associés

Pour les développeurs — accès API

Endpoint

Appeler depuis votre stack

Exemple de requête

Exemple de réponse

Tarifs

Erreurs

Notes techniques

Signification des valeurs de statut de visa et fonctionnement de la recherche

Contrat d'entrée, forme de la réponse et comportement d'erreur

Où une API stub d'exigence de visa apporte de la valeur

Cas d'intégration

QA et régression golden pour l'UX voyage

Widgets éducatifs et de contenu

Questions techniques

merci