flight-list-query

中国国内航班列表与参考票价查询

按出发城市、抵达城市和日期查询航班列表及参考最低票价。

调用价格

15 匠币/次

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

快速接入

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

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

cURL Python Go Java PHP

cURL 示例

curl --request GET \
  --url 'https://openapi.toolkk.com/v1/flight-list-query' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --data '{\n  "START_CITY": "北京",\n  "START_DATE": "20261009",\n  "END_CITY": "上海",\n  "END_DATE": "20261009"\n}'

Python 示例

import os
import requests

url = "https://openapi.toolkk.com/v1/flight-list-query"
payload = {
  "START_CITY": "北京",
  "START_DATE": "20261009",
  "END_CITY": "上海",
  "END_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-list-query"
    payload := []byte("{\n  \"START_CITY\": \"北京\",\n  \"START_DATE\": \"20261009\",\n  \"END_CITY\": \"上海\",\n  \"END_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  \"START_CITY\": \"北京\",\n  \"START_DATE\": \"20261009\",\n  \"END_CITY\": \"上海\",\n  \"END_DATE\": \"20261009\"\n}";

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://openapi.toolkk.com/v1/flight-list-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-list-query';
$payload = "{\n  \"START_CITY\": \"北京\",\n  \"START_DATE\": \"20261009\",\n  \"END_CITY\": \"上海\",\n  \"END_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;

响应示例

{
  "START_CITY": "北京",
  "START_DATE": "20190202",
  "END_CITY": "上海",
  "END_DATE": "20190202",
  "FLIGHTS": [
    {
      "START_AIRPORT_CH": "南苑机场",
      "START_AIRPORT_EN": "NAY",
      "START_TERMINAL_EN": "",
      "START_DATE": "20190202",
      "START_TIME": "21:00",
      "END_AIRPORT_CH": "浦东机场",
      "END_AIRPORT_EN": "PVG",
      "END_TERMINAL_EN": "T1",
      "END_DATE": "20190202",
      "END_TIME": "23:25",
      "FLIGHT_AIR_TIME": "浦东机场",
      "FLIGHT_AIR_IS_MORROW": "0",
      "FLIGHT_ID": "KN5987",
      "FLIGHT_PLANE_STYLE": "73V",
      "FLIGHT_PLANE_CN": "中型机",
      "FLIGHT_PLANE_TYPE": "2",
      "FLIGHT_AIRWAYS_EN": "KN",
      "FLIGHT_AIRWAYS_CH": "联合航空",
      "FLIGHT_LOWEST_PRICE": 342
    }
  ]
}

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

请求字段

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

请求字段

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

字段路径	类型	必填	说明	示例值
START_CITY	`string`	是	出发城市，如：北京	`北京`
START_DATE	`string`	是	出发日期，如：20190208	`20261009`
END_CITY	`string`	是	抵达城市，如：上海	`上海`
END_DATE	`string`	否	返程日期，如：20190208，若无返回日期，则填写出发日期	`20261009`

请求示例

{
  "START_CITY": "北京",
  "START_DATE": "20261009",
  "END_CITY": "上海",
  "END_DATE": "20261009"
}

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

响应字段

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

响应字段

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

字段路径	类型	必填	说明	示例值
START_CITY	`string`	否	未标注	`北京`
START_DATE	`string`	否	未标注	`20190202`
END_CITY	`string`	否	未标注	`上海`
END_DATE	`string`	否	未标注	`20190202`
FLIGHTS	`array`	否	未标注	`未标注`
FLIGHTS[]	`object`	未标注	未标注	`未标注`
FLIGHTS[].START_AIRPORT_CH	`string`	否	未标注	`南苑机场`
FLIGHTS[].START_AIRPORT_EN	`string`	否	未标注	`NAY`
FLIGHTS[].START_TERMINAL_EN	`string`	否	未标注	`未标注`
FLIGHTS[].START_DATE	`string`	否	未标注	`20190202`
FLIGHTS[].START_TIME	`string`	否	未标注	`21:00`
FLIGHTS[].END_AIRPORT_CH	`string`	否	未标注	`浦东机场`
FLIGHTS[].END_AIRPORT_EN	`string`	否	未标注	`PVG`
FLIGHTS[].END_TERMINAL_EN	`string`	否	未标注	`T1`
FLIGHTS[].END_DATE	`string`	否

接入文档

功能说明、使用场景与注意事项。

接口说明

按出发城市、抵达城市和日期查询航班列表及参考最低票价。

请求方式

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

请求参数

参数	类型	必填	说明
START_CITY	string	是	出发城市，如：北京
START_DATE	string	是	出发日期，如：20190208
END_CITY	string	是	抵达城市，如：上海
END_DATE	string	否	返程日期，如：20190208，若无返回日期，则填写出发日期

响应示例

{
  "START_CITY": "北京",
  "START_DATE": "20190202",
  "END_CITY": "上海",
  "END_DATE": "20190202",
  "FLIGHTS": [
    {
      "START_AIRPORT_CH": "南苑机场",
      "START_AIRPORT_EN": "NAY",
      "START_TERMINAL_EN": "",
      "START_DATE": "20190202",
      "START_TIME": "21:00",
      "END_AIRPORT_CH": "浦东机场",
      "END_AIRPORT_EN": "PVG",
      "END_TERMINAL_EN": "T1",
      "END_DATE": "20190202",
      "END_TIME": "23:25",
      "FLIGHT_AIR_TIME": "浦东机场",
      "FLIGHT_AIR_IS_MORROW": "0",
      "FLIGHT_ID": "KN5987",
      "FLIGHT_PLANE_STYLE": "73V",
      "FLIGHT_PLANE_CN": "中型机",
      "FLIGHT_PLANE_TYPE": "2",
      "FLIGHT_AIRWAYS_EN": "KN",
      "FLIGHT_AIRWAYS_CH": "联合航空",
      "FLIGHT_LOWEST_PRICE": 342
    }
  ]
}

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

中国国内航班列表与参考票价查询 API - 工具匠

中国国内航班列表与参考票价查询

快速接入

cURL 示例

Python 示例

Go 示例

Java 示例

PHP 示例

响应示例

请求字段

请求字段

请求示例

响应字段

响应字段

接入文档

接口说明

请求方式

请求参数

相关推荐

响应示例

请求示例

返回说明

使用限制

国内航班时刻表查询

航班号数据查询

航班实时状态查询

图片质量评分

英文简历解析

全球节日与纪念日查询

快速接入

cURL 示例

Python 示例

Go 示例

Java 示例

PHP 示例

响应示例

请求字段

请求字段

请求示例

响应字段

响应字段

接入文档

接口说明

请求方式

请求参数

相关推荐

相关工具

相关 API

响应示例

请求示例

返回说明

使用限制

国内航班时刻表查询

航班号数据查询

航班实时状态查询

图片质量评分

英文简历解析

全球节日与纪念日查询