接口API文档

调用说明

接口描述

通过输入列车车次,查询日期进行查询。

请求说明

接口域名

api.hangxx.com

请求示例

HTTP 方法:GET/POST

请求URL:https://接口域名/restapi/trainQuery/trainTime?authCode=鉴权码&trainCode=列车车次&queryDate=查询日期

url请求参数说明如下:

请求参数

参数 是否必选 类型 说明
authCode string 航讯讯应用鉴权码,个人中心 -> 应用管理 -> 新建应用 -> 获得应用鉴权码
trainCode string 列车车次
queryDate string 查询日期,格式:yyyy-MM-dd,如:1999-01-01,只能查询包括当天在内的往后15天的信息

请求代码示例

提示一:使用示例代码前,请记得替换相应的参数值。

提示二:部分语言依赖的类或库,请在代码注释中查看下载地址。

  • curl
  • Python
  • JAVA
  • PHP
  • C#
curl -i -X GET 'https://接口域名/restapi/trainQuery/trainTime?authCode=&trainCode=&queryDate='
#请先安装requests模块
url='https://接口域名/restapi/trainQuery/trainTime?authCode=
&trainCode=&queryDate='
r=requests.get(url)
print r.text
											
//请先导入httpclient相应的包
HttpClient httpclient = HttpClients.createDefault();
HttpGet get = new HttpGet("https://接口域名/restapi/trainQuery/trainTime?authCode=
&trainCode=&queryDate=");
HttpResponse response = httpclient.execute(get);
System.out.println(EntityUtils.toString(response.getEntity()));
										
<?php
    $host = "https://接口域名";
    $path = "/restapi/trainQuery/trainTime?authCode=
    &trainCode=&queryDate=";
    $method = "GET";
    $url = $host . $path;

    $curl = curl_init();
    curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
    curl_setopt($curl, CURLOPT_URL, $url);
    curl_setopt($curl, CURLOPT_FAILONERROR, false);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($curl, CURLOPT_HEADER, false);
    if (1 == strpos("$".$host, "https://"))
    {
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
        curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
    }
    curl_setopt($curl, CURLOPT_POSTFIELDS, $bodys);
    echo curl_exec($curl);
?>

using System.IO;
using System.Text;
using System.Net;
using System.Net.Security;
using System.Security.Cryptography.X509Certificates;

private const String host = "https://接口域名";
private const String path = "/restapi/trainQuery/trainTime?authCode=
    &trainCode=&queryDate=";
private const String method = "POST";

static void Main(string[] args)
{
    String querys = "";
    String url = host + path;
    HttpWebRequest httpRequest = null;
    HttpWebResponse httpResponse = null;

    if (0 < querys.Length)
    {
        url = url + "?" + querys;
    }

    if (host.Contains("https://"))
    {
        ServicePointManager.ServerCertificateValidationCallback = new RemoteCertificateValidationCallback
        (CheckValidationResult);
        httpRequest = (HttpWebRequest)WebRequest.CreateDefault(new Uri(url));
    }
    else
    {
        httpRequest = (HttpWebRequest)WebRequest.Create(url);
    }
    httpRequest.Method = method;
    try
    {
        httpResponse = (HttpWebResponse)httpRequest.GetResponse();
    }
    catch (WebException ex)
    {
        httpResponse = (HttpWebResponse)ex.Response;
    }

    Console.WriteLine(httpResponse.StatusCode);
    Console.WriteLine(httpResponse.Method);
    Console.WriteLine(httpResponse.Headers);
    Stream st = httpResponse.GetResponseStream();
    StreamReader reader = new StreamReader(st, Encoding.GetEncoding("utf-8"));
    Console.WriteLine(reader.ReadToEnd());
    Console.WriteLine("\n");

}

public static bool CheckValidationResult(object sender, X509Certificate certificate, X509Chain chain,
SslPolicyErrors errors)
{
    return true;
}

返回说明

返回结果示例

{
  "code": 200,
  "data": [
    {
      "station_name": "成都西",          //车站名称
      "train_class_name": "直特",        //列车类型
      "start_time": "21:11",            //出发时间
      "start_station_name": "成都西",    //始发站
      "station_train_code": "Z322",     //列车车次
      "arrive_day_str": "当日到达",      //到达描述
      "end_station_name": "拉萨",       //终点站
      "running_time": "00:00",         //行驶时长
      "arrive_day_diff": "0",          //跨越天数
      "station_no": "01",              //车站序号
      "arrive_time": "21:11"           //到达时间
    }
  ],
  "message": "查询成功"
}
                                                
 
©版权所有hangxx.com ICP备案号:渝ICP备2020011102号-2  渝公网安备 50010802005844号