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

中国国内航班实时状态查询 API - 工具匠

flight-status-query

中国国内航班实时状态查询

按航班号和日期查询航班实际状态、计划与实际起降时间、机场及航站楼信息。

利用料金

15 コイン/回

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

クイックスタート

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

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

cURL Python Go Java PHP

cURL 例

curl --request GET \
  --url 'https://openapi.toolkk.com/v1/flight-status-query' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --data '{\n  "FLIGHT_ID": "HU7610",\n  "DATE": "20261009"\n}'

Python 例

import os
import requests

url = "https://openapi.toolkk.com/v1/flight-status-query"
payload = {
  "FLIGHT_ID": "HU7610",
  "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-status-query"
    payload := []byte("{\n  \"FLIGHT_ID\": \"HU7610\",\n  \"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  \"FLIGHT_ID\": \"HU7610\",\n  \"DATE\": \"20261009\"\n}";

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://openapi.toolkk.com/v1/flight-status-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-status-query';
$payload = "{\n  \"FLIGHT_ID\": \"HU7610\",\n  \"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;

レスポンス例

[
  {
    "FLIGHT_STATUS": "接口查询状态",
    "FLIGHT_ACTUAL_STATUS": "延误",
    "FLIGHT_ID": "CA1373",
    "FLIGHT_AIRWAYS_CH": "中国国航",
    "START_AIRPORT_CH": "北京首都国际机场",
    "START_AIRPORT_EN": "PEK",
    "START_CITY": "北京",
    "START_TIME": "12:55",
    "ACTUAL_START_TIME": "20190130131600",
    "START_DATE": "20190130",
    "START_TERMINAL_EN": "T3",
    "END_AIRPORT_CH": "长沙黄花机场",
    "END_AIRPORT_EN": "CSX",
    "END_CITY": "长沙",
    "END_TIME": "15:30",
    "ACTUAL_END_TIME": "20190130153400",
    "END_DATE": "20190130",
    "END_TERMINAL_EN": "T1"
  }
]

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

リクエスト項目

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

リクエスト項目

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

パス	型	必須	説明	サンプル値
FLIGHT_ID	`string`	はい	航班编号，如：HU7610	`HU7610`
DATE	`string`	はい	日期，如：20200706	`20261009`

リクエスト例

{
  "FLIGHT_ID": "HU7610",
  "DATE": "20261009"
}

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

レスポンス項目

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

レスポンス項目

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

パス	型	必須	説明	サンプル値
[]	`object`	未指定	未指定	`未指定`
[].FLIGHT_STATUS	`string`	いいえ	接口查询状态	`未指定`
[].FLIGHT_ACTUAL_STATUS	`string`	いいえ	未指定	`延误`
[].FLIGHT_ID	`string`	いいえ	未指定	`CA1373`
[].FLIGHT_AIRWAYS_CH	`string`	いいえ	未指定	`中国国航`
[].START_AIRPORT_CH	`string`	いいえ	未指定	`北京首都国际机场`
[].START_AIRPORT_EN	`string`	いいえ	未指定	`PEK`
[].START_CITY	`string`	いいえ	未指定	`北京`
[].START_TIME	`string`	いいえ	未指定	`12:55`
[].ACTUAL_START_TIME	`string`	いいえ	未指定	`20190130131600`
[].START_DATE	`string`	いいえ	未指定	`20190130`
[].START_TERMINAL_EN	`string`	いいえ	未指定	`T3`
[].END_AIRPORT_CH	`string`	いいえ	未指定	`长沙黄花机场`
[].END_AIRPORT_EN	`string`	いいえ	未指定	`CSX`
[].END_CITY	`string`

導入ドキュメント

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

接口说明

按航班号和日期查询航班实际状态、计划与实际起降时间、机场及航站楼信息。

请求方式

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

请求参数

参数	类型	必填	说明
FLIGHT_ID	string	是	航班编号，如：HU7610
DATE	string	是	日期，如：20200706

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

请求示例

```json { "FLIGHT_ID": "HU7610", "DATE": "20261009" } ```

返回说明

レスポンス例

[
  {
    "FLIGHT_STATUS": "接口查询状态",
    "FLIGHT_ACTUAL_STATUS": "延误",
    "FLIGHT_ID": "CA1373",
    "FLIGHT_AIRWAYS_CH": "中国国航",
    "START_AIRPORT_CH": "北京首都国际机场",
    "START_AIRPORT_EN": "PEK",
    "START_CITY": "北京",
    "START_TIME": "12:55",
    "ACTUAL_START_TIME": "20190130131600",
    "START_DATE": "20190130",
    "START_TERMINAL_EN": "T3",
    "END_AIRPORT_CH": "长沙黄花机场",
    "END_AIRPORT_EN": "CSX",
    "END_CITY": "长沙",
    "END_TIME": "15:30",
    "ACTUAL_END_TIME": "20190130153400",
    "END_DATE": "20190130",
    "END_TERMINAL_EN": "T1"
  }
]

中国国内航班实时状态查询

クイックスタート

cURL 例

Python 例

Go 例

Java 例

PHP 例

レスポンス例

リクエスト項目

リクエスト項目

リクエスト例

レスポンス項目

レスポンス項目

導入ドキュメント

接口说明

请求方式

请求参数

请求示例

返回说明

関連リソース

レスポンス例

使用限制

航班列表与参考票价查询

国内航班时刻表查询

航班号数据查询

画像品質評価

英語履歴書解析

世界の祝日・記念日検索

クイックスタート

cURL 例

Python 例

Go 例

Java 例

PHP 例

レスポンス例

リクエスト項目

リクエスト項目

リクエスト例

レスポンス項目

レスポンス項目

導入ドキュメント

接口说明

请求方式

请求参数

请求示例

返回说明

関連リソース

関連ツール

関連 API

レスポンス例

使用限制

航班列表与参考票价查询

国内航班时刻表查询

航班号数据查询

画像品質評価

英語履歴書解析

世界の祝日・記念日検索