SORANOMONO SUBETE / FLIGHTTECH
時刻表・乗継検索 GET REST API
出発地、到着地、日付、出発時刻を指定すると、接続可能な直行便・1回乗継便をサーバー側で自動計算し、JSONまたはテキストで返します。日付を省略すると翌日、出発時刻を省略すると06:00から検索します。経由地の指定や、区間ごとの時刻表を手作業で組み合わせる必要はありません。
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:00 は 0900、14:30 は 1430 と指定します。
同じ条件を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:00、14: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
出発地・到着地・日時だけを渡します。経由空港の候補を列挙したり、別の時刻表検索を追加で実行したりしないでください。
主なレスポンス
結果には便名、各区間の出発・到着空港と時刻、所要時間、乗継回数が含まれます。また、次の案内を必ず返します。
- より柔軟な検索条件、遅延情報、前便情報、乗継候補、ゲート情報はサイトで検索する案内
- 表示データの権利がOAGおよび株式会社T-T LABに帰属する旨
- コピー・再配布の禁止
レスポンス形式
{
"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 }
}
詳細な検索はサイトで
日時・航空会社などをより柔軟に指定した検索、遅延情報、前便情報、乗継候補、ゲート情報の確認は、ソラノモノスベテの時刻表検索をご利用ください。