调用价格
15 匠币/次
快速接入
保持统一返回结构,直接通过服务端发起请求即可接入。
https://openapi.toolkk.com/v1/flight-number-querycURL 示例
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
- 默认限流
- 60 次/分钟
- 超时时间
- 30000 ms
服务端调用时,将 API Key 放在 X-API-Key 请求头中。
建议按 response code 与业务字段双重判断调用结果。
高频调用场景请结合速率限制与重试策略使用。
请求字段
从服务端发起请求,并在 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 查询参数中填写 STRING 和 PAGE_NUM,如航班号 HU7613、页码 1;字段大小写按请求标签页保留。检查业务返回码后读取航班记录数组及分页统计。当前响应字段仍使用数据源的中文名称,文档语言切换不会改变 JSON 字段名;统计数量和页码可能是字符串。
范围与限制
请求没有日期字段,因此无法据此判断指定日期是否执飞,也不提供订票或实时延误跟踪。计划时间、班期和准点率仅供参考。页数原样保留数据源值,有记录的第一页也可能显示总页数为字符串 0,不能据此丢弃已有航班。未返回记录时保留空状态,不要补造航线。
常见问题
同一个航班号为什么有多条记录?
不同参考班期、时刻或机型可能形成多条记录。应结合每条记录的班期与行程需求比较,不要只取第一条。
中文字段会随页面语言改变吗?
不会。当前 Product 保留中文响应字段;多语言简介只翻译说明文字。读取时以响应标签页的字段名称为准。
总页数是 0,但有两条记录怎么办?
保留并展示已返回的记录。该统计来自数据源,不能单独作为记录有效性的判断依据。
如何查询当天是否延误?
使用航班实时状态接口,提供航班号和日期,再读取实际运航状态与计划、实际起降时间。