flight-number-query

航班号数据查询

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

调用价格

15 匠币/次

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

快速接入

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

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",
      "本周参考航班": "日,四,六,二,三,五,一",
      "准点率": ""
    }
  ]
}

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

请求字段

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

请求字段

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

字段路径	类型	必填	说明	示例值
STRING	`string`	是	搜索字符串，如：AY6863	`AY6863`
PAGE_NUM	`string`	是	搜索结果页码序列，如：1	`1`

请求示例

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

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

响应字段

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

响应字段

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

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

返回说明

HKT

响应示例

{
  "索引条件": {
    "索引字符串": "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 保留接口原始字段，可能是对象或数组；中文字段和大写英文字段应原样读取。

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

航班号数据查询

快速接入

cURL 示例

Python 示例

Go 示例

Java 示例

PHP 示例

响应示例

请求字段

请求字段

请求示例

响应字段

响应字段

接入文档

接口说明

请求方式

请求参数

请求示例

返回说明

相关推荐

响应示例

使用限制

航班列表与参考票价查询

国内航班时刻表查询

航班实时状态查询

图片质量评分

英文简历解析

全球节日与纪念日查询

快速接入

cURL 示例

Python 示例

Go 示例

Java 示例

PHP 示例

响应示例

请求字段

请求字段

请求示例

响应字段

响应字段

接入文档

接口说明

请求方式

请求参数

请求示例

返回说明

相关推荐

相关工具

相关 API

响应示例

使用限制

航班列表与参考票价查询

国内航班时刻表查询

航班实时状态查询

图片质量评分

英文简历解析

全球节日与纪念日查询