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

中国国内航班号数据查询 API - 工具匠

flight-number-query

中国国内航班号数据查询

按航班号查询航线、航空公司、机场、计划起降时间和参考班期，支持分页。

利用料金

15 コイン/回

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

クイックスタート

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

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

cURL Python Go Java PHP

cURL 例

curl --request GET \
  --url 'https://openapi.toolkk.com/v1/flight-number-query' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --data '{\n  "STRING": "AY6863",\n  "PAGE_NUM": "1"\n}'

Python 例

import os
import requests

url = "https://openapi.toolkk.com/v1/flight-number-query"
payload = {
  "STRING": "AY6863",
  "PAGE_NUM": "1"
}

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-number-query"
    payload := []byte("{\n  \"STRING\": \"AY6863\",\n  \"PAGE_NUM\": \"1\"\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  \"STRING\": \"AY6863\",\n  \"PAGE_NUM\": \"1\"\n}";

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

レスポンス例

{
  "索引条件": {
    "索引字符串": "AY6863"
  },
  "索引状态": "一切都如您的神机妙算，天下均在您的掌握之中",
  "索引总数量": "2",
  "索引总页数": "0",
  "索引页容量": "10",
  "索引页序号": "1",
  "索引实体信息": [
    {
      "数据编码": "0000618A49CF960D91DD25A2C4B6FC75",
      "出发洲际_中文": "亚洲",
      "出发洲际_英文": "AISA",
      "出发国家_中文": "泰国",
      "出发国家_英文": "THAILAND",
      "出发城市": "普吉岛",
      "出发城市缩写": "HKT",
      "出发城市拼音": "PHUKET",
      "抵达洲际_中文": "亚洲",
      "抵达洲际_英文": "AISA",
      "抵达国家_中文": "泰国",
      "抵达国家_英文": "THAILAND",
      "抵达城市": "曼谷",
      "抵达城市缩写": "BKK",
      "抵达城市拼音": "BANGKOK",
      "航班号": "AY6863",
      "航空公司": "芬兰航空",
      "机型": "空客320",
      "开始时间": "17:30",
      "结束时间": "19:00",
      "起飞机场": "素万那普国际机场",
      "抵达机场": "普吉国际机场D",
      "本周参考航班": "日,四,六,二,三,五,一",
      "准点率": ""
    }
  ]
}

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

リクエスト項目

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

リクエスト項目

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

パス	型	必須	説明	サンプル値
STRING	`string`	はい	搜索字符串，如：AY6863	`AY6863`
PAGE_NUM	`string`	はい	搜索结果页码序列，如：1	`1`

リクエスト例

{
  "STRING": "AY6863",
  "PAGE_NUM": "1"
}

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

レスポンス項目

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

レスポンス項目

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

パス	型	必須	説明	サンプル値
索引条件	`object`	いいえ	未指定	`未指定`
索引条件.索引字符串	`string`	いいえ	未指定	`AY6863`
索引状态	`string`	いいえ	未指定	`一切都如您的神机妙算，天下均在您的掌握之中`
索引总数量	`string`	いいえ	未指定	`2`
索引总页数	`string`	いいえ	未指定	`0`
索引页容量	`string`	いいえ	未指定	`10`
索引页序号	`string`	いいえ	未指定	`1`
索引实体信息	`array`	いいえ	未指定	`未指定`
索引实体信息[]	`object`	未指定	未指定	`未指定`
索引实体信息[].数据编码	`string`	いいえ	未指定	`0000618A49CF960D91DD25A2C4B6FC75`
索引实体信息[].出发洲际_中文	`string`	いいえ	未指定	`亚洲`
索引实体信息[].出发洲际_英文	`string`	いいえ	未指定	`AISA`
索引实体信息[].出发国家_中文	`string`	いいえ	未指定	`泰国`
索引实体信息[].出发国家_英文	`string`	いいえ	未指定	`THAILAND`
索引实体信息[].出发城市	`string`	いいえ	未指定	`普吉岛`
索引实体信息[].出发城市缩写	`string`

導入ドキュメント

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

接口说明

按航班号查询航线、航空公司、机场、计划起降时间和参考班期，支持分页。

请求方式

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

请求参数

参数	类型	必填	说明
STRING	string	是	搜索字符串，如：AY6863
PAGE_NUM	string	是	搜索结果页码序列，如：1

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

请求示例

```json { "STRING": "AY6863", "PAGE_NUM": "1" } ```

返回说明

レスポンス例

{
  "索引条件": {
    "索引字符串": "AY6863"
  },
  "索引状态": "一切都如您的神机妙算，天下均在您的掌握之中",
  "索引总数量": "2",
  "索引总页数": "0",
  "索引页容量": "10",
  "索引页序号": "1",
  "索引实体信息": [
    {
      "数据编码": "0000618A49CF960D91DD25A2C4B6FC75",
      "出发洲际_中文": "亚洲",
      "出发洲际_英文": "AISA",
      "出发国家_中文": "泰国",
      "出发国家_英文": "THAILAND",
      "出发城市": "普吉岛",
      "出发城市缩写": "HKT",
      "出发城市拼音": "PHUKET",
      "抵达洲际_中文": "亚洲",
      "抵达洲际_英文": "AISA",
      "抵达国家_中文": "泰国",
      "抵达国家_英文": "THAILAND",
      "抵达城市": "曼谷",
      "抵达城市缩写": "BKK",
      "抵达城市拼音": "BANGKOK",
      "航班号": "AY6863",
      "航空公司": "芬兰航空",
      "机型": "空客320",
      "开始时间": "17:30",
      "结束时间": "19:00",
      "起飞机场": "素万那普国际机场",
      "抵达机场": "普吉国际机场D",
      "本周参考航班": "日,四,六,二,三,五,一",
      "准点率": ""
    }
  ]
}

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

中国国内航班号数据查询

クイックスタート

cURL 例

Python 例

Go 例

Java 例

PHP 例

レスポンス例

リクエスト項目

リクエスト項目

リクエスト例

レスポンス項目

レスポンス項目

導入ドキュメント

接口说明

请求方式

请求参数

请求示例

返回说明

関連リソース

レスポンス例

使用限制

航班列表与参考票价查询

国内航班时刻表查询

航班实时状态查询

画像品質評価

英語履歴書解析

世界の祝日・記念日検索

クイックスタート

cURL 例

Python 例

Go 例

Java 例

PHP 例

レスポンス例

リクエスト項目

リクエスト項目

リクエスト例

レスポンス項目

レスポンス項目

導入ドキュメント

接口说明

请求方式

请求参数

请求示例

返回说明

関連リソース

関連ツール

関連 API

レスポンス例

使用限制

航班列表与参考票价查询

国内航班时刻表查询

航班实时状态查询

画像品質評価

英語履歴書解析

世界の祝日・記念日検索