接口API文档

调用说明

接口描述

通过输入出发车站编码,到达车站编码,查询日期,车票类型进行查询。

请求说明

接口域名

api.hangxx.com

请求示例

HTTP 方法:GET/POST

请求URL:https://接口域名/restapi/trainQuery/ticketBalance?authCode=鉴权码&leaveCode=出发车站编码&arriveCode=到达车站编码&queryDate=查询日期&ticketType=车票类型

url请求参数说明如下:

请求参数

参数 是否必选 类型 说明
authCode string 航讯讯应用鉴权码,个人中心 -> 应用管理 -> 新建应用 -> 获得应用鉴权码
leaveCode string 出发车站编码
arriveCode string 到达车站编码
queryDate string 查询日期,格式:yyyy-MM-dd,如:1999-01-01,只能查询包括当天在内的往后15天的信息
ticketType string 车票类型,选传,A - 普通票,S - 学生票,默认A

请求代码示例

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

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

  • curl
  • Python
  • JAVA
  • PHP
  • C#
curl -i -X GET 'https://接口域名/restapi/trainQuery/ticketBalance?authCode=&leaveCode=&arriveCode=&queryDate=&ticketType='
#请先安装requests模块
url='https://接口域名/restapi/trainQuery/ticketBalance?authCode=
&leaveCode=&arriveCode=&queryDate=&ticketType='
r=requests.get(url)
print r.text
											
//请先导入httpclient相应的包
HttpClient httpclient = HttpClients.createDefault();
HttpGet get = new HttpGet("https://接口域名/restapi/trainQuery/ticketBalance?authCode=
&leaveCode=&arriveCode=&queryDate=&ticketType=");
HttpResponse response = httpclient.execute(get);
System.out.println(EntityUtils.toString(response.getEntity()));
										
<?php
    $host = "https://接口域名";
    $path = "/restapi/trainQuery/ticketBalance?authCode=&leaveCode=
    &arriveCode=&queryDate=&ticketType=";
    $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/ticketBalance?authCode=&leaveCode=
    &arriveCode=&queryDate=&ticketType=";
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": [
        {
            "from_station_name": "北京丰台",    //出发站
            "station_train_code": "Z181",      //列车车次
            "zy_num": "无",                    //一等座余票
            "gr_num": "无",                    //高级卧铺余票
            "qt_num": "无",                    //其他票余额
            "start_station_telecode": "FMC",   //始发站编码
            "rw_num": "16",                    //软卧余票
            "arrive_time": "05:11",            //到达时间
            "start_train_date": "20250323",    //列车出发时间
            "from_station_telecode": "FTP",    //出发站编码
            "start_time": "03:49",             //出发时间
            "srrb_num": "无",                  //动卧余票
            "lishi": "25:22",                  //历时
            "yz_num": "有",                    //硬座余票
            "to_station_name": "深圳东",        //到达站
            "train_no": "3c0000Z18401",        //列车编号
            "end_station_telecode": "BJQ",     //终点站编号
            "ze_num": "无",                    //二等座余票
            "tz_num": "无",                    //特等座余票
            "swz_num": "无",                   //商务座余票
            "to_station_telecode": "BJQ",      //到达站编码
            "wz_num": "无"                     //无座余票
        }
    ],
    "message": "查询成功"
}
                                                
 
©版权所有hangxx.com ICP备案号:渝ICP备2020011102号-2  渝公网安备 50010802005844号