Cookie の使用について.本サイトでは、基本機能の提供に必要な必須 Cookie を使用しています。さらに、同意いただいた場合に限り、アクセス解析 Cookie を利用して利用状況を把握し、サービス改善に役立てます。詳しくは .

中国国内航班列表与参考票价查询 API - 工具匠

flight-list-query

中国国内航班列表与参考票价查询

按出发城市、抵达城市和日期查询航班列表及参考最低票价。

利用料金

15 コイン/回

クイックスタートリクエスト項目レスポンス項目 API 紹介

クイックスタート

統一レスポンス形式のまま、バックエンドから直接呼び出せます。

GEThttps://openapi.toolkk.com/v1/flight-list-query

cURL Python Go Java PHP

cURL 例

curl --request GET \
  --url 'https://openapi.toolkk.com/v1/flight-list-query' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --data '{\n  "START_CITY": "北京",\n  "START_DATE": "20261009",\n  "END_CITY": "上海",\n  "END_DATE": "20261009"\n}'

Python 例

import os
import requests

url = "https://openapi.toolkk.com/v1/flight-list-query"
payload = {
  "START_CITY": "北京",
  "START_DATE": "20261009",
  "END_CITY": "上海",
  "END_DATE": "20261009"
}

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-list-query"
    payload := []byte("{\n  \"START_CITY\": \"北京\",\n  \"START_DATE\": \"20261009\",\n  \"END_CITY\": \"上海\",\n  \"END_DATE\": \"20261009\"\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  \"START_CITY\": \"北京\",\n  \"START_DATE\": \"20261009\",\n  \"END_CITY\": \"上海\",\n  \"END_DATE\": \"20261009\"\n}";

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://openapi.toolkk.com/v1/flight-list-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-list-query';
$payload = "{\n  \"START_CITY\": \"北京\",\n  \"START_DATE\": \"20261009\",\n  \"END_CITY\": \"上海\",\n  \"END_DATE\": \"20261009\"\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;

レスポンス例

{
  "START_CITY": "北京",
  "START_DATE": "20190202",
  "END_CITY": "上海",
  "END_DATE": "20190202",
  "FLIGHTS": [
    {
      "START_AIRPORT_CH": "南苑机场",
      "START_AIRPORT_EN": "NAY",
      "START_TERMINAL_EN": "",
      "START_DATE": "20190202",
      "START_TIME": "21:00",
      "END_AIRPORT_CH": "浦东机场",
      "END_AIRPORT_EN": "PVG",
      "END_TERMINAL_EN": "T1",
      "END_DATE": "20190202",
      "END_TIME": "23:25",
      "FLIGHT_AIR_TIME": "浦东机场",
      "FLIGHT_AIR_IS_MORROW": "0",
      "FLIGHT_ID": "KN5987",
      "FLIGHT_PLANE_STYLE": "73V",
      "FLIGHT_PLANE_CN": "中型机",
      "FLIGHT_PLANE_TYPE": "2",
      "FLIGHT_AIRWAYS_EN": "KN",
      "FLIGHT_AIRWAYS_CH": "联合航空",
      "FLIGHT_LOWEST_PRICE": 342
    }
  ]
}

例はレスポンスの構造を示しています。実際の結果はAPIの応答によって異なります。

リクエスト項目

サーバーからリクエストを送信し、X-API-Keyヘッダーにキーを設定してください。

リクエスト項目

APIスキーマに基づく項目です。説明や例がない場合は未指定と表示します。

パス	型	必須	説明	サンプル値
START_CITY	`string`	はい	出发城市，如：北京	`北京`
START_DATE	`string`	はい	出发日期，如：20190208	`20261009`
END_CITY	`string`	はい	抵达城市，如：上海	`上海`
END_DATE	`string`	いいえ	返程日期，如：20190208，若无返回日期，则填写出发日期	`20261009`

リクエスト例

{
  "START_CITY": "北京",
  "START_DATE": "20261009",
  "END_CITY": "上海",
  "END_DATE": "20261009"
}

認証方式: リクエストヘッダーに X-API-Key を設定
レート制限: 毎分 60 回
タイムアウト: 30000 ms

レスポンス項目

例はレスポンスの構造を示しています。実際の結果はAPIの応答によって異なります。

レスポンス項目

APIスキーマに基づく項目です。説明や例がない場合は未指定と表示します。

パス	型	必須	説明	サンプル値
START_CITY	`string`	いいえ	未指定	`北京`
START_DATE	`string`	いいえ	未指定	`20190202`
END_CITY	`string`	いいえ	未指定	`上海`
END_DATE	`string`	いいえ	未指定	`20190202`
FLIGHTS	`array`	いいえ	未指定	`未指定`
FLIGHTS[]	`object`	未指定	未指定	`未指定`
FLIGHTS[].START_AIRPORT_CH	`string`	いいえ	未指定	`南苑机场`
FLIGHTS[].START_AIRPORT_EN	`string`	いいえ	未指定	`NAY`
FLIGHTS[].START_TERMINAL_EN	`string`	いいえ	未指定	`未指定`
FLIGHTS[].START_DATE	`string`	いいえ	未指定	`20190202`
FLIGHTS[].START_TIME	`string`	いいえ	未指定	`21:00`
FLIGHTS[].END_AIRPORT_CH	`string`	いいえ	未指定	`浦东机场`
FLIGHTS[].END_AIRPORT_EN	`string`	いいえ	未指定	`PVG`
FLIGHTS[].END_TERMINAL_EN	`string`	いいえ	未指定	`T1`
FLIGHTS[].END_DATE

導入ドキュメント

機能、利用シーン、注意事項。

接口说明

按出发城市、抵达城市和日期查询航班列表及参考最低票价。

请求方式

GET /v1/flight-list-query，通过查询字符串传参，参数名称区分大小写。

请求参数

参数	类型	必填	说明
START_CITY	string	是	出发城市，如：北京
START_DATE	string	是	出发日期，如：20190208
END_CITY	string	是	抵达城市，如：上海
END_DATE	string	否	返程日期，如：20190208，若无返回日期，则填写出发日期

レスポンス例

{
  "START_CITY": "北京",
  "START_DATE": "20190202",
  "END_CITY": "上海",
  "END_DATE": "20190202",
  "FLIGHTS": [
    {
      "START_AIRPORT_CH": "南苑机场",
      "START_AIRPORT_EN": "NAY",
      "START_TERMINAL_EN": "",
      "START_DATE": "20190202",
      "START_TIME": "21:00",
      "END_AIRPORT_CH": "浦东机场",
      "END_AIRPORT_EN": "PVG",
      "END_TERMINAL_EN": "T1",
      "END_DATE": "20190202",
      "END_TIME": "23:25",
      "FLIGHT_AIR_TIME": "浦东机场",
      "FLIGHT_AIR_IS_MORROW": "0",
      "FLIGHT_ID": "KN5987",
      "FLIGHT_PLANE_STYLE": "73V",
      "FLIGHT_PLANE_CN": "中型机",
      "FLIGHT_PLANE_TYPE": "2",
      "FLIGHT_AIRWAYS_EN": "KN",
      "FLIGHT_AIRWAYS_CH": "联合航空",
      "FLIGHT_LOWEST_PRICE": 342
    }
  ]
}

日期格式为 yyyyMMdd；文档示例仅展示数据结构，不代表当前航班或票价。

中国国内航班列表与参考票价查询

クイックスタート

cURL 例

Python 例

Go 例

Java 例

PHP 例

レスポンス例

リクエスト項目

リクエスト項目

リクエスト例

レスポンス項目

レスポンス項目

導入ドキュメント

接口说明

请求方式

请求参数

関連リソース

レスポンス例

请求示例

返回说明

使用限制

国内航班时刻表查询

航班号数据查询

航班实时状态查询

画像品質評価

英語履歴書解析

世界の祝日・記念日検索

クイックスタート

cURL 例

Python 例

Go 例

Java 例

PHP 例

レスポンス例

リクエスト項目

リクエスト項目

リクエスト例

レスポンス項目

レスポンス項目

導入ドキュメント

接口说明

请求方式

请求参数

関連リソース

関連ツール

関連 API

レスポンス例

请求示例

返回说明

使用限制

国内航班时刻表查询

航班号数据查询

航班实时状态查询

画像品質評価

英語履歴書解析

世界の祝日・記念日検索