flight-status-query

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

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

调用价格

15 匠币/次

快速接入请求字段响应字段接口简介

快速接入

保持统一返回结构，直接通过服务端发起请求即可接入。

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"
  }
]

示例用于理解返回结构，实际结果以接口返回为准。

请求字段

从服务端发起请求，并在 X-API-Key 请求头中传入密钥。

请求字段

字段来自接口结构定义。未提供的说明和示例会标为未标注。

字段路径	类型	必填	说明	示例值
FLIGHT_ID	`string`	是	航班编号，如：HU7610	`HU7610`
DATE	`string`	是	日期，如：20200706	`20261009`

请求示例

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

鉴权方式: 请求头传入 X-API-Key
默认限流: 60 次/分钟
超时时间: 30000 ms

响应字段

示例用于理解返回结构，实际结果以接口返回为准。

响应字段

字段来自接口结构定义。未提供的说明和示例会标为未标注。

字段路径	类型	必填	说明	示例值
[]	`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"
  }
]

调用通过工具匠 API 统一返回 code、message、data。data 保留接口原始字段，可能是对象或数组；中文字段和大写英文字段应原样读取。

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

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

快速接入

cURL 示例

Python 示例

Go 示例

Java 示例

PHP 示例

响应示例

请求字段

请求字段

请求示例

响应字段

响应字段

接入文档

接口说明

请求方式

请求参数

请求示例

返回说明

相关推荐

响应示例

使用限制

航班列表与参考票价查询

国内航班时刻表查询

航班号数据查询

图片质量评分

英文简历解析

全球节日与纪念日查询

快速接入

cURL 示例

Python 示例

Go 示例

Java 示例

PHP 示例

响应示例

请求字段

请求字段

请求示例

响应字段

响应字段

接入文档

接口说明

请求方式

请求参数

请求示例

返回说明

相关推荐

相关工具

相关 API

响应示例

使用限制

航班列表与参考票价查询

国内航班时刻表查询

航班号数据查询

图片质量评分

英文简历解析

全球节日与纪念日查询