Requisito visto
Con un passaporto statunitense il Messico non richiede il visto per soggiorni fino a 180 giorni, secondo una piccola tabella fissa di 25 coppie di Paesi. Inserisca i codici di due lettere di passaporto e destinazione e veda uno dei tre stati del visto. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Paese del passaporto
- US
- Paese di destinazione
- MX
- Chiave della coppia
- US>MX
- Stato del visto
- visa_free
- Etichetta di stato
- Visa-free
- Dimensione del tavolo
- 25
Pianificare un viaggio internazionale inizia quasi sempre con la stessa domanda pratica: il Suo passaporto necessita di un visto per quella destinazione? Si tratta di dati educativi e facili da integrare—non di un parere d'ambasciata in tempo reale—, pertanto Lei deve sempre verificare gli itinerari critici con fonti ufficiali prima della partenza.
Cosa significano i valori di stato del visto e come funziona la ricerca
Questa capacità risponde a una domanda ristretta e di alto valore: per un dato Paese emittente del passaporto e un Paese di destinazione, cosa dice la tabella di riferimento stub sulle formalità d'ingresso? Sono supportati tre esiti. Visa required significa che il viaggiatore deve ottenere un visto (o un'autorizzazione elettronica approvata trattata come visto pre-viaggio) prima dell'imbarco o del controllo di frontiera; la risposta non inventa URL di consolati né moduli, etichetta solo lo stato affinché il Suo prodotto possa indirizzare l'utente al passo successivo.
Visa on arrival significa che la tabella registra che un visto o un permesso equivalente può essere rilasciato al punto d'ingresso secondo le regole dello stub, spesso con una permanenza massima suggerita in giorni quando la riga include tale dettaglio. Visa-free significa che la tabella registra che l'ingresso di breve soggiorno non richiede una domanda di visto separata per quel passaporto e quella destinazione nei dati dello stub.
L'algoritmo è deliberatamente semplice e deterministico: normalizza entrambi i campi Paese in codici ISO 3166-1 alpha-2 di due lettere maiuscole, rifiuta codici malformati e coppie dello stesso Paese, costruisce una chiave di coppia della forma PASSPORT greater-than DESTINATION e interroga una mappa hash in memoria.
Quando serve un controllo rapido del visto
I marketplace di viaggio e le sandbox di prenotazione necessitano di un segnale affidabile per mostrare badge di visto obbligatorio prima che il carrello venga abbandonato, ma i feed governativi in diretta sono instabili, con limiti di frequenza o su licenza. Uno stub di livello parse con tabella fissa consente ai team di prodotto di consegnare il percorso UX, scrivere test end-to-end e formare il supporto su tre stati discreti senza dipendere dalla rete.
Le piattaforme educative e d'esame che insegnano la normativa turistica possono interrogare gli apprendenti sui codici Paese ISO e mappare gli stati senza fare scraping di Wikipedia. Gli strumenti interni che normalizzano i record del nome passeggero spesso necessitano di un controllo secondario economico: dato il Paese di emissione del passaporto e la destinazione dell'itinerario, allegare un flag stub per la revisione operativa. La convalida fallita non consuma saldo.
Casi d'uso
Badge visto in prenotazione e checkout
Mostri etichette senza visto, visto all'arrivo o visto obbligatorio nei riepiloghi di viaggio quando la coppia passaporto del passeggero e destinazione esiste nella tabella stub.
Domande frequenti
Cosa succede se la coppia di Paesi non è nella tabella di riferimento?
Lo stub non inventa mai una politica di visto per combinazioni passaporto–destinazione sconosciute, e la convalida fallita non viene addebitata.
Si tratta di un parere ufficiale sul visto in tempo reale?
No. È una tabella di riferimento stub deterministica per demo di prodotto, test e ricerche educative. Confermi sempre le regole d'ingresso con ambasciate o fonti governative ufficiali prima di viaggiare.
Quale formato di codice Paese è accettato?
Solo codici ISO 3166-1 alpha-2 di due lettere, senza distinzione di maiuscole (US, us e Us si normalizzano a US). Codici a tre lettere, nomi come Mexico e coppie dello stesso Paese sono rifiutati.
Che cosa significano i tre stati del visto?
Visto obbligatorio significa ottenere un visto o un'autorizzazione elettronica approvata prima di partire. Visto all'arrivo indica che il permesso può essere concesso alla frontiera. Visto non necessario indica un breve soggiorno senza domanda separata.
Il risultato dice quanto posso restare?
Solo quando la riga della tabella riporta un soggiorno massimo. Per un passaporto statunitense diretto in Messico indica fino a 180 giorni; per le coppie senza quel dato non viene indicato alcun limite.
Strumenti correlati
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo 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)Esempio di richiesta
{
"passport_country": "US",
"destination_country": "MX"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "travel.visa_required_check_stub",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
Note tecniche
Quando la coppia non è presente nella tabella, la chiamata fallisce con invalid_input anziché inventare una norma.
Cosa significano i valori di stato del visto e come funziona la ricerca
Un esito positivo restituisce visa_status, uno status_label leggibile, max_stay_days opzionale se noto, notes e metadati come table_size e method. Una mancata corrispondenza solleva invalid_input nominando la coppia assente. Ricordi che la politica reale dei visti cambia con nazionalità, scopo del viaggio, rifiuti precedenti e accordi bilaterali; questo stub congela un piccolo insieme educativo così i team di ingegneria possono collegare UX e fatturazione senza fare scraping del web né chiamare API di visti a pagamento durante lo sviluppo.
Contratto di ingresso, forma della risposta e comportamento di errore
Se entrambi i codici sono validi e diversi ma la coppia ordinata è assente dalla tabella di riferimento incorporata, l'attività fallisce con un messaggio chiaro che la coppia di Paesi non è nella tabella di riferimento—tali fallimenti non vengono addebitati. Invii un corpo JSON tramite POST con due campi stringa obbligatori: passport_country e destination_country. Ciascun valore deve essere un codice Paese ISO 3166-1 alpha-2 di due lettere; la maiuscola/minuscola è ignorata, gli spazi laterali sono rimossi e qualsiasi cosa che non siano esattamente due lettere latine dopo la normalizzazione fallisce con invalid_input nominando il campo. Payload numerici o oggetti per quei campi sono rifiutati. In caso di successo il corpo riecheggia passport_country e destination_country normalizzati, il pair_key usato per la ricerca, visa_status come uno tra visa_required, visa_on_arrival o visa_free, uno status_label adatto all'interfaccia, notes che descrivono la riga dello stub, in_reference_table impostato a true, method impostato a stub_reference_table_lookup e table_size uguale al numero di coppie attualmente fornite. Quando la riga include una permanenza massima positiva, max_stay_days è presente come intero; quando lo stub non definisce un limite di soggiorno per quella coppia il campo è omesso del tutto anziché restituito come null, in linea con il contratto del renderer per le uscite opzionali. Esempio: passport_country US e destination_country MX producono visa_free con un max_stay_days di più mesi nella tabella stub. Esempio: passport_country US e destination_country CN producono visa_required senza max_stay_days. Abbini la risposta ai Suoi moduli di idoneità, cattura foto del passaporto o deep link d'ambasciata se Le serve un imbuto di domanda completo; questo endpoint classifica solo la coppia rispetto alla tabella di riferimento e non elabora domande, non raccoglie biometria né controlla liste di sorveglianza.
Dove un'API stub sul requisito di visto crea valore
Poiché l'implementazione è parse puro di livello A, ogni chiamata riuscita costa il prezzo base pubblicato $0.002 senza token di modello e senza rete in uscita. Questa combinazione fornisce valori visa_status riproducibili per demo, plugin LMS e edge worker senza allestire una pipeline di dati geopolitici propria.
Casi di integrazione
QA e regressione golden per l'UX di viaggio
Guida test deterministici dei flussi di onboarding di viaggio con coppie ISO fisse invece di scraper d'ambasciata instabili in diretta.
Widget educativi e di contenuto
Consenta ad apprendenti e lettori di consultare stati di esempio passaporto–destinazione nel browser con la stessa logica che l'API addebita a $0.002.
Domande tecniche
Come verifico se è richiesto un visto per la mia destinazione?
Invii passport_country e destination_country come codici ISO 3166-1 alpha-2 (ad esempio US e MX). L'API restituisce visa_status come visa_required, visa_on_arrival o visa_free quando la coppia è nella tabella di riferimento.
Quanto costa il controllo del requisito di visto?
Lo strumento del browser è gratuito. Le richieste API usano il saldo prepagato KIT a $0.002 per chiamata riuscita; l'input non valido non viene addebitato.