Visumpflicht prüfen
Mit einem US-Pass ist Mexiko für Aufenthalte bis 180 Tage visumfrei, laut einer kleinen festen Tabelle mit 25 Länderpaaren. Geben Sie die zweistelligen Codes von Pass und Ziel ein und sehen Sie einen von drei Visumstatus. Kostenlos in Ihrem Browser.
- Kostenlos
- Läuft in Ihrem Browser
- Ohne Anmeldung
- Ihre Daten bleiben auf Ihrem Gerät
Im Browser ausführen – kostenlos
Rechenbeispiel
- Passland
- US
- Zielland
- MX
- Paarschlüssel
- US>MX
- Visumstatus
- visa_free
- Statusbezeichnung
- Visa-free
- Tischgröße
- 25
Die Planung einer internationalen Reise beginnt fast immer mit derselben praktischen Frage: braucht Ihr Reisepass ein Visum für dieses Ziel? Es handelt sich um Bildungs- und Integrationsdaten—nicht um live Botschaftsberatung—, weshalb Sie kritische Reiserouten vor der Abreise stets mit offiziellen Quellen prüfen sollten.
Was die Visumstatus-Werte bedeuten und wie die Suche funktioniert
Diese Fähigkeit beantwortet eine enge, aber hochwertige Frage: Was sagt die Stub-Referenztabelle für ein gegebenes passausstellendes Land und ein Zielland über die Einreiseformalitäten? Drei Ergebnisse werden unterstützt. Visa required bedeutet, dass der Reisende vor dem Boarding oder der Grenzkontrolle ein Visum (oder eine genehmigte elektronische Genehmigung, die als Vorabvisum gilt) einholen sollte; die Antwort erfindet weder Konsulats-URLs noch Formulare, sie etikettiert nur den Status, damit Ihr Produkt den Nutzer zum nächsten Schritt leiten kann.
Visa on arrival bedeutet, dass die Tabelle festhält, dass ein Visum oder eine gleichwertige Erlaubnis am Einreiseort nach den Stub-Regeln erteilt werden kann, oft mit einer vorgeschlagenen Höchstaufenthaltsdauer in Tagen, wenn die Zeile dieses Detail enthält. Visa-free bedeutet, dass die Tabelle festhält, dass eine Kurzaufenthalts-Einreise für diesen Pass und dieses Ziel in den Stub-Daten keinen separaten Visumantrag erfordert. Der Algorithmus ist bewusst einfach und deterministisch: beide Länderfelder auf zweistellige ISO-3166-1-alpha-2-Codes in Großbuchstaben normalisieren, fehlerhafte Codes und gleiche-Länder-Paare ablehnen, einen Paarschlüssel der Form PASSPORT greater-than DESTINATION bauen und eine In-Memory-Hashmap abfragen.
Bedenken Sie, dass reale Visapolitik mit Staatsangehörigkeit, Reisezweck, früheren Ablehnungen und bilateralen Abkommen wechselt; dieser Stub friert eine kleine Bildungsmenge ein, damit Engineering-Teams UX und Abrechnung verdrahten können, ohne das Web zu scrapen oder während der Entwicklung bezahlte Visum-APIs zu rufen.
Wann eine schnelle Visumprüfung hilft
Reisemarktplätze und Buchungs-Sandboxes brauchen ein zuverlässiges Signal, um Visum-erforderlich-Badges anzuzeigen, bevor der Warenkorb abgebrochen wird, doch live Regierungsfeeds sind unzuverlässig, ratenbegrenzt oder lizenziert. Ein Parse-Tier-Stub mit fester Tabelle lässt Produktteams den UX-Pfad ausliefern, Ende-zu-Ende-Tests schreiben und Support-Mitarbeitende auf drei diskrete Status trainieren, ohne vom Netz abzuhängen. Bildungs- und Prüfungsplattformen, die Tourismusregeln vermitteln, können Lernende zu ISO-Ländercodes abfragen und Status zuordnen, ohne Wikipedia zu scrapen.
Interne Werkzeuge, die Passenger-Name-Records normalisieren, brauchen oft eine günstige Zweitprüfung: bei gegebenem Passausstellungsland und Reiseroute ein Stub-Flag für die Betriebsprüfung anhängen. Fehlgeschlagene Validierung wird nicht berechnet.
Anwendungsfälle
Visum-Badges bei Buchung und Checkout
Zeigen Sie visumfrei, Visum bei Ankunft oder Visum erforderlich auf Reiseübersichten, wenn das Paar aus Passagierpass und Ziel in der Stub-Tabelle existiert.
Häufige Fragen
Was passiert, wenn das Länderpaar nicht in der Referenztabelle steht?
Der Stub erfindet nie eine Visapolitik für unbekannte Pass-Ziel-Kombinationen, und fehlgeschlagene Validierung wird nicht berechnet.
Ist das live offizielle Visumberatung?
Nein. Es ist eine deterministische Stub-Referenztabelle für Produktdemos, Tests und Bildungsabfragen. Bestätigen Sie Einreiseregeln vor der Reise stets bei Botschaften oder offiziellen Behördenquellen.
Welches Ländercode-Format wird akzeptiert?
Nur zweistellige ISO-3166-1-alpha-2-Codes, groß-/kleinschreibungsunabhängig (US, us und Us werden zu US normalisiert). Dreistellige Codes, Namen wie Mexico und gleiche-Länder-Paare werden abgelehnt.
Was bedeuten die drei Visumstatus?
Visumpflicht heißt, vor der Reise ein Visum oder eine genehmigte elektronische Einreiseerlaubnis zu beschaffen. Visum bei Ankunft heißt, die Erlaubnis kann an der Grenze erteilt werden. Visumfrei heißt Kurzaufenthalt ohne gesonderten Antrag.
Zeigt das Ergebnis, wie lange ich bleiben darf?
Nur wenn die Tabellenzeile eine Höchstdauer enthält. Für einen US-Pass mit Ziel Mexiko sind es bis zu 180 Tage; bei Paaren ohne diese Angabe wird keine Grenze genannt.
Verwandte Tools
Für Entwickler — API-Zugang
Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.
Endpunkt
Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.
Aufruf aus Ihrem 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)Beispiel-Anfrage
{
"passport_country": "US",
"destination_country": "MX"
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "travel.visa_required_check_stub",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.
Preis
Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.
Fehler
| HTTP | Code | Bedeutung |
|---|---|---|
401 | unauthorized | Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer). |
402 | insufficient_balance | Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht. |
404 | unknown_type | Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog. |
429 | rate_limited | Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt. |
Technische Hinweise
Fehlt das Paar in der Tabelle, schlägt der Aufruf mit invalid_input fehl, statt eine Politik zu erfinden.
Was die Visumstatus-Werte bedeuten und wie die Suche funktioniert
Ein Treffer liefert visa_status, ein lesbares status_label, optional max_stay_days falls bekannt, notes sowie Metadaten wie table_size und method. Ein Fehlschlag wirft invalid_input und benennt das fehlende Paar.
Eingabevertrag, Antwortform und Fehlerverhalten
Sind beide Codes gültig und verschieden, fehlt das geordnete Paar jedoch in der eingebauten Referenztabelle, scheitert die Aufgabe mit einer klaren Meldung, dass das Länderpaar nicht in der Referenztabelle steht—solche Fehler werden nicht berechnet. Kombinieren Sie die Antwort mit eigenen Eignungsformularen, Passfoto-Erfassung oder Botschafts-Deep-Links, falls Sie einen vollständigen Antragsfunnel brauchen; dieser Endpunkt klassifiziert nur das Paar gegen die Referenztabelle und bearbeitet keine Anträge, erfasst keine Biometrie und prüft keine Beobachtungslisten. Senden Sie per POST einen JSON-Body mit zwei Pflicht-Stringfeldern: passport_country und destination_country. Jeder Wert muss ein zweistelliger ISO-3166-1-alpha-2-Ländercode sein; Groß-/Kleinschreibung wird ignoriert, umgebende Leerzeichen werden entfernt, und alles, was nach der Normalisierung nicht genau zwei lateinische Buchstaben ist, scheitert mit invalid_input und benennt das Feld. Numerische oder Objekt-Payloads für diese Felder werden abgelehnt. Bei Erfolg spiegelt der Body die normalisierten passport_country und destination_country, den für die Abfrage genutzten pair_key, visa_status als eines von visa_required, visa_on_arrival oder visa_free, ein für die Oberfläche geeignetes status_label, notes zur Stub-Zeile, in_reference_table true, method stub_reference_table_lookup und table_size gleich der Anzahl der derzeit ausgelieferten Paare. Enthält die Zeile eine positive Höchstaufenthaltsdauer, ist max_stay_days als Ganzzahl vorhanden; definiert der Stub für dieses Paar kein Limit, wird das Feld vollständig weggelassen statt als null zurückgegeben—entsprechend dem Renderer-Vertrag für optionale Ausgaben. Beispiel: passport_country US und destination_country MX ergeben visa_free mit einem mehrmonatigen max_stay_days in der Stub-Tabelle. Beispiel: passport_country US und destination_country CN ergeben visa_required ohne max_stay_days.
Wo eine Stub-API zur Visumpflicht ihren Nutzen entfaltet
Weil die Implementierung reines Parse-Tier-A ist, kostet jeder erfolgreiche Aufruf den veröffentlichten Basispreis $0.002 ohne Modell-Tokens und ohne ausgehendes Netz. Diese Kombination liefert reproduzierbare visa_status-Werte für Demos, LMS-Plugins und Edge-Worker, ohne eine eigene geopolitische Datenpipeline aufzubauen.
Integrationsbeispiele
QA und Golden-Regression für Reise-UX
Steuern Sie deterministische Tests für Reise-Onboarding mit festen ISO-Paaren statt unzuverlässiger Live-Botschafts-Scraper.
Bildungs- und Inhalts-Widgets
Lassen Sie Lernende und Leser Beispielstatus Pass–Ziel im Browser nachschlagen—mit derselben Logik, die die API mit $0.002 abrechnet.
Technische Fragen
Wie prüfe ich, ob für mein Ziel ein Visum nötig ist?
Senden Sie passport_country und destination_country als ISO-3166-1-alpha-2-Codes (zum Beispiel US und MX). Die API liefert visa_status als visa_required, visa_on_arrival oder visa_free, wenn das Paar in der Referenztabelle steht.
Was kostet die Visumpflicht-Prüfung?
Das Browser-Werkzeug ist kostenlos. API-Anfragen nutzen vorausbezahltes KIT-Guthaben zu $0.002 pro erfolgreichem Aufruf; ungültige Eingaben werden nicht berechnet.