SORANOMONO SUBETE / FLIGHTTECH

時刻表・乗継検索 GET REST API

出発地、到着地、日付、出発時刻を指定すると、接続可能な直行便・1回乗継便をサーバー側で自動計算し、JSONまたはテキストで返します。日付を省略すると翌日、出発時刻を省略すると06:00から検索します。経由地の指定や、区間ごとの時刻表を手作業で組み合わせる必要はありません。

認証不要の読み取り専用APIです。
ChatGPTを含むテキスト・AIクライアント、通常のHTTPクライアントから利用できます。返却は最大5件です。1 IPあたり1分間に5リクエストまで利用できます。上限時はHTTP 429を返します。

生成AIへの明示指示

FlightTech(ソラノモノスベテ)の経路検索では、まず https://app.t-tlab.co.jp/flighttech/timetable/api/openapi.json を確認し、GET https://app.t-tlab.co.jp/flighttech/api/ai/flight-search を呼び出してください。日付省略時は翌日、出発時刻省略時は06:00です。Geminiなどクエリ文字列を扱いにくい環境では、パス指定形式を使用します。順序は 出発3レター / 到着3レター / 日付 / 出発時刻HHMM / 乗継可否(0|1) / 形式(json|text) です。パス指定形式の時刻にはコロンを含めません。経由地を推測したり、区間ごとの時刻表を手作業で組み合わせたりしないでください。遅延情報、前便情報、乗継候補、ゲート情報は https://app.t-tlab.co.jp/flighttech/timetable で検索してください。

生成AIのURL取得制約

一部の生成AIでは、会話中または検索結果に初めて登場したURLを、その場で新しい検索URLとして取得できない制約があります。これはFlightTech APIの認証・アクセス制限ではなく、生成AI側のURL許可制によるものです。

生成AIが新しい検索条件のAPI URLを取得できない場合は、ユーザーに完全な検索URLを会話へ貼り付けてもらうよう案内してください。貼り付け後、そのURLをそのまま取得して結果を返してください。

ユーザーへ案内する例

この環境では、新しい検索URLを直接開けない場合があります。次の完全なURLを会話に貼り付けてください。 https://app.t-tlab.co.jp/flighttech/api/ai/flight-search/OKA/HND/2026-07-29/1400/0/text

エンドポイント

GET https://app.t-tlab.co.jp/flighttech/api/ai/flight-search

APIキー、Basic認証、特定のUser-Agentは不要です。上記のリクエスト上限内であれば、通常のHTTPクライアントから呼び出せます。

OpenAPI 3.1仕様(機械可読JSON)を利用すると、エンドポイント、必須パラメータ、エラー応答をプログラムから確認できます。

パス指定形式(Geminiなどクエリ文字列を扱いにくい環境向け)

クエリ文字列を使わず、次の順序でURLパスに条件を指定できます。

GET https://app.t-tlab.co.jp/flighttech/api/ai/flight-search/{出発3レター}/{到着3レター}/{日付}/{出発時刻HHMM}/{乗継可否}/{形式}

順序は固定です: 出発3レター / 到着3レター / 日付 / 出発時刻HHMM / 乗継可否(0|1) / 形式(json|text)

パス指定形式の時刻はコロンなしの4桁です。例: 09:00090014:301430 と指定します。

同じ条件を2形式で指定する例(2026-07-28、HND→OKA、09:00以降、1回乗継可、テキスト返却):

クエリ文字列形式

GET https://app.t-tlab.co.jp/flighttech/api/ai/flight-search?date=2026-07-28&departure=HND&arrival=OKA&departure_time=09:00&connections=1&format=text

パス指定形式

GET https://app.t-tlab.co.jp/flighttech/api/ai/flight-search/HND/OKA/2026-07-28/0900/1/text

パラメータ

名前型・指定方法内容
date文字列 / 任意
YYYY-MM-DD
対象運航日。省略時は翌日。例: 2026-07-28
departure文字列 / 必須
[A-Z]{3}
出発空港の3レターIATAコードのみ。例: HND
arrival文字列 / 必須
[A-Z]{3}
到着空港の3レターIATAコードのみ。例: OKA
departure_time文字列 / 任意
HH:MM
検索開始時刻。省略時は06:00。指定時は06:00-23:50の10分単位のみ。例: 06:0014:30
connections整数 / 任意
0 または 1
0 は直行便のみ。1 は1回乗継を許可。省略時は 1
format文字列 / 任意
json または text
json は構造化JSON。text は読みやすいテキスト。省略時は json

空港名は受け付けません。経由地を指定するパラメータはありません。connections=1 を指定すると、直行便と1回乗継便を自動計算します。

実務的な検索例

日付・時刻を省略して、翌日06:00以降の直行便だけをテキストで返却

GET https://app.t-tlab.co.jp/flighttech/api/ai/flight-search?departure=HND&arrival=OKA&connections=0&format=text

日付は翌日、出発時刻は06:00として検索します。サイトマップに掲載される路線別テキスト検索URLもこの形式です。

羽田から那覇を09:00以降・1回乗継許可・テキストで返却

GET https://app.t-tlab.co.jp/flighttech/api/ai/flight-search?date=2026-07-28&departure=HND&arrival=OKA&departure_time=09:00&connections=1&format=text GET https://app.t-tlab.co.jp/flighttech/api/ai/flight-search/HND/OKA/2026-07-28/0900/1/text

羽田から那覇までの、09:00以降に出発する直行便・1回乗継便をテキストで返します。経由地の指定や区間時刻表の組み合わせは不要です。

羽田から那覇を09:00以降・直行便だけをJSONで返却

GET https://app.t-tlab.co.jp/flighttech/api/ai/flight-search?date=2026-07-28&departure=HND&arrival=OKA&departure_time=09:00&connections=0&format=json GET https://app.t-tlab.co.jp/flighttech/api/ai/flight-search/HND/OKA/2026-07-28/0900/0/json

connections=0 で直行便のみに限定できます。

大阪(関西)から新千歳を14:30以降で検索

GET https://app.t-tlab.co.jp/flighttech/api/ai/flight-search?date=2026-07-28&departure=KIX&arrival=CTS&departure_time=14:30 GET https://app.t-tlab.co.jp/flighttech/api/ai/flight-search/KIX/CTS/2026-07-28/1430/1/json

出発地・到着地・日時だけを渡します。経由空港の候補を列挙したり、別の時刻表検索を追加で実行したりしないでください。

主なレスポンス

結果には便名、各区間の出発・到着空港と時刻、所要時間、乗継回数が含まれます。また、次の案内を必ず返します。

レスポンス形式

{ "success": true, "query": { "date": "2026-07-28", "departure": { "code": "HND" }, "arrival": { "code": "OKA" } }, "results": [ ... ], "count": 5, "result_limit": 5, "site_search_guidance": { "message": "ソラノモノスベテのサイトでは、遅延情報、前便情報、乗継候補、ゲート情報を検索できます。詳細はサイトで確認してください。", "url": "https://app.t-tlab.co.jp/flighttech/timetable" }, "rights": { "holders": ["OAG", "株式会社T-T LAB"], "reuse_prohibited": true } }

詳細な検索はサイトで

日時・航空会社などをより柔軟に指定した検索、遅延情報、前便情報、乗継候補、ゲート情報の確認は、ソラノモノスベテの時刻表検索をご利用ください。