呼叫價格
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;不能因此捨棄已取得的航班。沒有紀錄時保留空狀態,不要自行補造航線。
常見問題
同一航班號為何有多筆資料?
不同班期、時刻或機型可能形成不同紀錄。須逐筆比較班期及行程需求,不要一律選第一筆。
英文頁面會回傳英文欄位嗎?
目前不會。多語言版本翻譯說明文字,JSON 仍採中文欄位;以回應分頁所列名稱為準。
總頁數為 0,但已有資料怎麼辦?
保留並顯示已回傳的紀錄,不要只憑總頁數認定整個查詢沒有結果。
如何核對當日是否延誤?
改用航班即時狀態查詢,提供航班號與日期,再讀取運航狀態及計畫、實際起降時間。