domestic-flight-schedule

中国国内航班时刻表查询

按出发城市、抵达城市、航空公司或航班号查询国内航班时刻表，支持分页。

调用价格

15 匠币/次

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

快速接入

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

GEThttps://openapi.toolkk.com/v1/domestic-flight-schedule

cURL Python Go Java PHP

cURL 示例

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

Python 示例

import os
import requests

url = "https://openapi.toolkk.com/v1/domestic-flight-schedule"
payload = {
  "START_CITY": "北京",
  "END_CITY": "上海",
  "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/domestic-flight-schedule"
    payload := []byte("{\n  \"START_CITY\": \"北京\",\n  \"END_CITY\": \"上海\",\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  \"START_CITY\": \"北京\",\n  \"END_CITY\": \"上海\",\n  \"PAGE_NUM\": \"1\"\n}";

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

响应示例

{
  "索引条件": {
    "索引字符串": "北京_海南航空"
  },
  "索引状态": "一切都如您的神机妙算，天下均在您的掌握之中",
  "索引总数量": "64",
  "索引总页数": "2",
  "索引页容量": "25",
  "索引页序号": "1",
  "索引实体信息": [
    {
      "出发城市": "北京",
      "抵达城市": "广州",
      "航班号": "HU7719",
      "航空公司": "海南航空",
      "机型": "",
      "开始时间": "17:55",
      "结束时间": "20:20",
      "起飞机场": "广州白云国际机场T1",
      "抵达机场": "郑州新郑国际机场T2",
      "本周参考航班": "一,三,五,日",
      "准点率": "95%",
      "数据编码": "089EB9712FDF9F7F2AF34056B05A21BB"
    }
  ]
}

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

请求字段

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

请求字段

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

字段路径	类型	必填	说明	示例值
START_CITY	`string`	否	出发城市，如：北京	`北京`
END_CITY	`string`	否	抵达城市，如：上海	`上海`
AIRLINE_COMPANY	`string`	否	航空公司，如：海南航空	`海南航空`
PLANE_ID	`string`	否	航班号，如：CA1104	`CA1104`
PAGE_NUM	`string`	是	搜索结果页码序列，如：1	`1`

请求示例

{
  "START_CITY": "北京",
  "END_CITY": "上海",
  "PAGE_NUM": "1"
}

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

响应字段

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

响应字段

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

字段路径	类型	必填	说明	示例值
索引条件	`object`	否	未标注	`未标注`
索引条件.索引字符串	`string`	否	未标注	`北京_海南航空`
索引状态	`string`	否	未标注	`一切都如您的神机妙算，天下均在您的掌握之中`
索引总数量	`string`	否	未标注	`64`
索引总页数	`string`	否	未标注	`2`
索引页容量	`string`	否	未标注	`25`
索引页序号	`string`	否	未标注	`1`
索引实体信息	`array`	否	未标注	`未标注`
索引实体信息[]	`object`	未标注	未标注	`未标注`
索引实体信息[].出发城市	`string`	否	未标注	`北京`
索引实体信息[].抵达城市	`string`	否	未标注	`广州`
索引实体信息[].航班号	`string`	否	未标注	`HU7719`
索引实体信息[].航空公司	`string`	否	未标注	`海南航空`
索引实体信息[].机型	`string`	否	未标注	`未标注`
索引实体信息[].开始时间	`string`	否	未标注	`17:55`
索引实体信息[].结束时间	`string`	否	未标注	`20:20`
索引实体信息[].起飞机场

接入文档

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

接口说明

按出发城市、抵达城市、航空公司或航班号查询国内航班时刻表，支持分页。

请求方式

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

请求参数

参数	类型	必填	说明
START_CITY	string	否	出发城市，如：北京
END_CITY	string	否	抵达城市，如：上海
AIRLINE_COMPANY	string	否	航空公司，如：海南航空
PLANE_ID	string	否	航班号，如：CA1104
PAGE_NUM

响应示例

{
  "索引条件": {
    "索引字符串": "北京_海南航空"
  },
  "索引状态": "一切都如您的神机妙算，天下均在您的掌握之中",
  "索引总数量": "64",
  "索引总页数": "2",
  "索引页容量": "25",
  "索引页序号": "1",
  "索引实体信息": [
    {
      "出发城市": "北京",
      "抵达城市": "广州",
      "航班号": "HU7719",
      "航空公司": "海南航空",
      "机型": "",
      "开始时间": "17:55",
      "结束时间": "20:20",
      "起飞机场": "广州白云国际机场T1",
      "抵达机场": "郑州新郑国际机场T2",
      "本周参考航班": "一,三,五,日",
      "准点率": "95%",
      "数据编码": "089EB9712FDF9F7F2AF34056B05A21BB"
    }
  ]
}

中国国内航班时刻表查询 API - 工具匠

中国国内航班时刻表查询

快速接入

cURL 示例

Python 示例

Go 示例

Java 示例

PHP 示例

响应示例

请求字段

请求字段

请求示例

响应字段

响应字段

接入文档

接口说明

请求方式

请求参数

相关推荐

响应示例

请求示例

返回说明

使用限制

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

中国国内航班号数据查询

中国国内航班实时状态查询

图片质量评分

英文简历解析

全球节日与纪念日查询

快速接入

cURL 示例

Python 示例

Go 示例

Java 示例

PHP 示例

响应示例

请求字段

请求字段

请求示例

响应字段

响应字段

接入文档

接口说明

请求方式

请求参数

相关推荐

相关工具

相关 API

响应示例

请求示例

返回说明

使用限制

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

中国国内航班号数据查询

中国国内航班实时状态查询

图片质量评分

英文简历解析

全球节日与纪念日查询