ビザ要否確認

表にペアが無い場合は方針を捏造せず invalid_input で失敗します。

ビザ状態の値の意味と照会の仕組み

本機能は、狭いが高価値な問いに答えます。旅券発行国と渡航先国が与えられたとき、スタブ参照表は入国手続きについて何と述べているか。応答は領事館 URL や申請書を捏造せず、状態にラベルを付けるだけなので、製品は利用者を次の手順へ誘導できます。アルゴリズムは意図的に単純で決定論的です。結果は三つです。 visa_required は、搭乗や国境審査の前にビザ（または渡航前ビザとして扱う承認済み電子許可）を取得すべきことを意味します。visa_on_arrival は、スタブルールの下で入国地点でビザまたは同等の許可が与えられ得ることを表が記録していることを意味し、行に詳細がある場合は日数での上限滞在が付くことがよくあります。visa_free は、その旅券と渡航先について短期入国に別途ビザ申請が不要であると表が記録していることを意味します。両国フィールドを大文字の二文字 ISO 3166-1 alpha-2 に正規化し、不正コードと同一国ペアを拒否し、PASSPORT greater-than DESTINATION 形式のペアキーを作り、メモリ上のハッシュマップを探します。ヒット時は visa_status、人が読める status_label、既知なら任意の max_stay_days、notes、および table_size と method などのメタデータを返します。ミス時は欠けたペア名を付けて invalid_input を投げます。実際のビザ政策は国籍・渡航目的・過去の拒否・二国間協定で変わる点に留意し、本スタブは教育用の小さな集合を固定することで、開発中にウェブをスクレイプしたり有料ビザ API を呼んだりせずに UX と課金を配線できるようにしています。

入力契約・応答形・エラー動作

両コードが有効でも同一なら、国内移動は国境を越えるビザ照会の範囲外のためハンドラは要求を拒否します。両コードが有効かつ異なり、それでも順序付きペアが内蔵参照表に無い場合、国ペアが参照表に無いという明確なメッセージでタスクは失敗し、それらの失敗は課金されません。完全な申請ファネルが必要なら、ご自身の適格フォーム・旅券写真・大使館ディープリンクと組み合わせてください。必須の文字列フィールド passport_country と destination_country を持つ JSON 本体を POST してください。各値は二文字の ISO 3166-1 alpha-2 国コードでなければならず、大文字小文字は無視され、前後の空白は除去され、正規化後にちょうど二文字のラテン文字でないものはフィールド名付きの invalid_input で失敗します。それらのフィールドへの数値やオブジェクトのペイロードは拒否されます。成功時の本体は正規化済みの passport_country と destination_country、照会に使った pair_key、visa_required・visa_on_arrival・visa_free のいずれかである visa_status、UI 向けの status_label、スタブ行を説明する notes、true の in_reference_table、stub_reference_table_lookup の method、現在出荷されているペア数に等しい table_size を返します。行に正の最大滞在がある場合は max_stay_days が整数として現れ、スタブがそのペアの滞在上限を定義しない場合は null ではなくフィールド自体が省略され、任意出力に関するレンダラ契約に合致します。例：passport_country US と destination_country MX はスタブ表で数か月の max_stay_days 付き visa_free になります。例：passport_country US と destination_country CN は max_stay_days 無しの visa_required になります。本エンドポイントは参照表に対してペアを分類するだけで、申請処理・生体情報収集・ウォッチリスト照合は行いません。

ビザ要否スタブ API が価値を生む場面

実装は純粋な parse ティア A のため、成功した呼び出しは毎回公開の基本価格 $0.002 で、モデルトークンも外向きネットワークもありません。これにより、地政学データパイプラインを自前で立てずに、デモ・LMS プラグイン・エッジワーカー向けの再現可能な visa_status が得られます。