POST已開放train-schedule-query

火車時刻與餘票查詢

根據出發站、到達站和乘車日期，查詢全國列車車次、發到時刻、各席位價格及餘票狀態快照，適用於出行規劃與票務資訊展示。

接入文件

介面能力

本介面提供全國火車時刻表及餘票狀態的查詢服務。使用者輸入出發站、到達站和指定日期，即可獲取符合條件的列車車次列表、出發與到達時間、歷時，以及不同席位（如二等座、一等座等）的價格和餘票快照資訊。

請求與返回

請求引數：需提供出發站（start）、到達站（end）、乘車日期（date，格式 YYYY-MM-DD），並可透過 ishigh 引數篩選是否僅查詢高鐵/動車。
返回結果：返回包含列車資訊的列表。每條記錄包括車次號（trainno）、出發時間（departuretime）、到達時間（arrivaltime），以及各席位的價格（price）和餘票數量/狀態（num）。

使用場景

出行規劃應用：整合至旅遊、日曆或行程管理工具中，為使用者提供便捷的車次查詢服務。
票務資訊展示：用於企業差旅系統或本地生活服務平臺，展示列車時刻與大致餘票情況。
資料分析輔助：為交通流量分析、熱門路線研究提供基礎的時刻表資料支援。

使用說明與限制

介面返回的餘票和價格資訊為查詢時點的參考快照，由於票務資料實時變動劇烈，不保證與實際購票時的絕對一致。
本介面僅提供資訊查詢，不具備購票、改簽或退票功能。
實際的列車停運、晚點、票價調整及最終購票結果，請務必以 12306 官方網站及車站實時公告為準。

接入示例程式碼

提供 Shell、Python、Go、Java、PHP 等常見接入示例，便於直接接到現有專案裡。

請求示例

{
  "start": "北京南",
  "end": "上海虹桥",
  "ishigh": "1",
  "date": "2026-07-20"
}

響應示例

{
  "code": 200,
  "msg": "成功",
  "taskNo": "example",
  "data": {
    "date": "2026-07-20",
    "start": "北京南",
    "end": "上海虹桥",
    "list": [
      {
        "trainno": "G1",
        "departuretime": "07:00",
        "arrivaltime": "11:30",
        "ze": {
          "price": "553.0",
          "num": "有"
        }
      }
    ]
  }
}

請求欄位

以下欄位根據示例 JSON 自動提取，僅作接入參考。

欄位路徑	型別	示例值
start	string	北京南
end	string	上海虹桥
ishigh	string	1
date	string	2026-07-20

響應欄位

以下欄位根據示例 JSON 自動提取，僅作接入參考。

欄位路徑	型別	示例值
code	number	200
msg	string	成功
taskNo	string	example
data	object	{...}
data.date	string	2026-07-20
data.start	string	北京南
data.end	string	上海虹桥
data.list	array

curl --request POST \ --url 'https://openapi.toolkk.com/v1/train-schedule-query' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "start": "北京南",\n "end": "上海虹桥",\n "ishigh": "1",\n "date": "2026-07-20"\n}'

import os import requests url = "https://openapi.toolkk.com/v1/train-schedule-query" payload = { "start": "北京南", "end": "上海虹桥", "ishigh": "1", "date": "2026-07-20" } headers = { "Content-Type": "application/json", "X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"), } response = requests.request("POST", url, headers=headers, json=payload, timeout=30) response.raise_for_status() print(response.json())

package main import ( "bytes" "fmt" "io" "net/http" ) func main() { endpoint := "https://openapi.toolkk.com/v1/train-schedule-query" payload := []byte("{\n \"start\": \"北京南\",\n \"end\": \"上海虹桥\",\n \"ishigh\": \"1\",\n \"date\": \"2026-07-20\"\n}") req, err := http.NewRequest("POST", 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)) }

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\": \"北京南\",\n \"end\": \"上海虹桥\",\n \"ishigh\": \"1\",\n \"date\": \"2026-07-20\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/train-schedule-query")) .method("POST", 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 $endpoint = 'https://openapi.toolkk.com/v1/train-schedule-query'; $payload = "{\n \"start\": \"北京南\",\n \"end\": \"上海虹桥\",\n \"ishigh\": \"1\",\n \"date\": \"2026-07-20\"\n}"; $ch = curl_init($endpoint); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'POST', 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;

火車時刻與餘票查詢

接入文件

介面能力

請求與返回

使用場景

使用說明與限制

接入示例程式碼

請求示例

響應示例

請求欄位

響應欄位

Shell 示例

Python 示例

Go 示例

Java 示例

PHP 示例

線上除錯