利用料金
25 コイン/回
クイックスタート
統一レスポンス形式のまま、バックエンドから直接呼び出せます。
https://openapi.toolkk.com/v1/flight-querycURL 例
curl --request GET \
--url 'https://openapi.toolkk.com/v1/flight-query' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: YOUR_API_KEY' \
--data '{\n "departure": "HGH",\n "arrival": "WUH",\n "departureDate": "2026-09-30"\n}'Python 例
import os
import requests
url = "https://openapi.toolkk.com/v1/flight-query"
payload = {
"departure": "HGH",
"arrival": "WUH",
"departureDate": "2026-09-30"
}
headers = {
"Content-Type": "application/json",
"X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"),
}
response = requests.get(url, headers=headers, params=payload, timeout=30)
response.raise_for_status()
print(response.json())Go 例
package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
endpoint := "https://openapi.toolkk.com/v1/flight-query"
payload := []byte("{\n \"departure\": \"HGH\",\n \"arrival\": \"WUH\",\n \"departureDate\": \"2026-09-30\"\n}")
req, err := http.NewRequest("GET", endpoint, bytes.NewBuffer(payload))
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-API-Key", "YOUR_API_KEY")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(string(body))
}Java 例
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class ToolkkExample {
public static void main(String[] args) throws Exception {
String payload = "{\n \"departure\": \"HGH\",\n \"arrival\": \"WUH\",\n \"departureDate\": \"2026-09-30\"\n}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://openapi.toolkk.com/v1/flight-query"))
.method("GET", HttpRequest.BodyPublishers.ofString(payload))
.header("Content-Type", "application/json")
.header("X-API-Key", "YOUR_API_KEY")
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}PHP 例
<?php
$endpoint = 'https://openapi.toolkk.com/v1/flight-query';
$payload = "{\n \"departure\": \"HGH\",\n \"arrival\": \"WUH\",\n \"departureDate\": \"2026-09-30\"\n}";
$ch = curl_init($endpoint);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'X-API-Key: YOUR_API_KEY',
],
CURLOPT_POSTFIELDS => $payload,
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
curl_close($ch);
echo $response;レスポンス例
{
"success": true,
"code": "200",
"message": "成功",
"data": {
"list": [
{
"arrivalCityCode": "WUH",
"duration": "1小时40分",
"departureCityCode": "HGH",
"price": {
"discountRate": 0.74,
"adultPrice": "670.00",
"childPrice": "460.00",
"infantPrice": "无"
},
"airlineCode": "GJ",
"departureDateTime": "2026-06-30 20:40:00",
"arrivalDateTime": "2026-06-30 22:20:00",
"state": "航班计划",
"departureAirportCode": "HGH",
"aircraftName": "波音737(中)",
"departureTerminal": "T4",
"arrivalAirportCode": "WUH",
"flightType": "direct",
"flightNo": "GJ3072",
"departureCityName": "杭州",
"arrivalCityName": "武汉",
"aircraftCode": "73H",
"departureAirportName": "萧山国际机场",
"airlineName": "长龙航空",
"arrivalAirportName": "天河国际机场",
"segments": []
}
]
}
}例はレスポンスの構造を示しています。実際の結果はAPIの応答によって異なります。
- 認証方式
- リクエストヘッダーに X-API-Key を設定
- レート制限
- 毎分 60 回
- タイムアウト
- 30000 ms
サーバー側から呼び出す際は、X-API-Key ヘッダーに API Key を設定します。
HTTP ステータスと業務フィールドの両方で成功判定するのがおすすめです。
高頻度利用ではレート制限と再試行戦略を併用してください。
リクエスト項目
サーバーからリクエストを送信し、X-API-Keyヘッダーにキーを設定してください。
リクエスト項目
APIスキーマに基づく項目です。説明や例がない場合は未指定と表示します。
| パス | 型 | 必須 | 説明 | サンプル値 |
|---|---|---|---|---|
| departure | string | はい | 出发城市或机场三字码 | HGH |
| arrival | string | はい | 到达城市或机场三字码 | WUH |
| departureDate | string | いいえ | 选填;省略时使用服务商当天日期 | 2026-09-30 |
リクエスト例
{
"departure": "HGH",
"arrival": "WUH",
"departureDate": "2026-09-30"
}- 認証方式
- リクエストヘッダーに X-API-Key を設定
- レート制限
- 毎分 60 回
- タイムアウト
- 30000 ms
レスポンス項目
例はレスポンスの構造を示しています。実際の結果はAPIの応答によって異なります。
レスポンス項目
APIスキーマに基づく項目です。説明や例がない場合は未指定と表示します。
| パス | 型 | 必須 | 説明 | サンプル値 |
|---|---|---|---|---|
| success | boolean | いいえ | 未指定 | true |
| code | string | いいえ | 未指定 | 200 |
| message | string | いいえ | 未指定 | 成功 |
| data | object | いいえ | 未指定 | 未指定 |
| data.list | array | いいえ | 未指定 | [{"arrivalCityCode":"WUH","duration":"1小时40分","departureCityCode":"HGH","price":{"discountRate":0.74,"adultPrice":"670.00","childPrice":"460.00","infantPrice":"无"},"airlineCode":"GJ","departureDateTime":"2026-06-30 20:40:00","arrivalDateTime":"2026-06-30 22:20:00","state":"航班计划","departureAirportCode":"HGH","aircraftName":"波音737(中)","departureTerminal":"T4","arrivalAirportCode":"WUH","flightType":"direct","flightNo":"GJ3072","departureCityName":"杭州","arrivalCityName":"武汉","aircraftCode":"73H","departureAirportName":"萧山国际机场","airlineName":"长龙航空","arrivalAirportName":"天河国际机场","segments":[]}] |
| data.list[] | object | 未指定 | 未指定 | 未指定 |
レスポンス例
{
"success": true,
"code": "200",
"message": "成功",
"data": {
"list": [
{
"arrivalCityCode": "WUH",
"duration": "1小时40分",
"departureCityCode": "HGH",
"price": {
"discountRate": 0.74,
"adultPrice": "670.00",
"childPrice": "460.00",
"infantPrice": "无"
},
"airlineCode": "GJ",
"departureDateTime": "2026-06-30 20:40:00",
"arrivalDateTime": "2026-06-30 22:20:00",
"state": "航班计划",
"departureAirportCode": "HGH",
"aircraftName": "波音737(中)",
"departureTerminal": "T4",
"arrivalAirportCode": "WUH",
"flightType": "direct",
"flightNo": "GJ3072",
"departureCityName": "杭州",
"arrivalCityName": "武汉",
"aircraftCode": "73H",
"departureAirportName": "萧山国际机场",
"airlineName": "长龙航空",
"arrivalAirportName": "天河国际机场",
"segments": []
}
]
}
}APIの概要
機能、利用シーン、制約、よくある質問。
フライト情報・参考運賃検索
出発地・到着地の3文字コードから、時刻、運航状況、機材、ターミナルと大人・小児・幼児の参考運賃を検索できます。
GET /v1/flight-query
リクエストパラメータ
| Parameter | Type | Description |
|---|---|---|
| departure | string | 必須:出発都市・空港の3文字コード。例:HGH、BJS |
| arrival | string | 必須:到着都市・空港の3文字コード。例:WUH |
| departureDate | string | 任意:YYYY-MM-DD。省略時は提供元の当日 |
レスポンス
成功時の data.list はフライト配列です。flightNo、airlineCode/airlineName、departureDateTime/arrivalDateTime、空港コードと名称、duration、提供元の state、、、、 を含みます。