接口API文档

调用说明

接口描述

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

请求说明

接口域名

api.hangxx.com

请求示例

HTTP 方法:GET/POST

请求URL:https://接口域名/restapi/trainQuery/ticketBalancePrice?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,目前只支持A

请求代码示例

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

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

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

返回说明

返回结果示例

{
    "status": 200,
    "message": "查询成功",
    "data": [
        {
            "departureTime": "21:21",
            "businessSeat": "",
            "trainStartCode": "SHH",
            "canSell": 0,
            "trainCode": "D710",
            "trainNo": "550000D71000",
            "dwFlag": "复",
            "arriveStationCode": "VNP",
            "grwSeat": "",
            "tdSeat": "",
            "arriveTime": "09:24",
            "tourist": "无",
            "queryDate": "20231215",
            "isTerminalStation": 1,
            "qtSeat": "",
            "rwSeat": "无",
            "departureStationCode": "SHH",
            "secondSeat": "无",
            "departureStation": "上海",
            "ydwSeat": "无",
            "bullet": "",
            "softSeat": "无",
            "noSeat": "4",
            "isSupportCard": "1",
            "trainEndCode": "VNP",
            "arriveStation": "北京南",
            "fromstationno": "01",
            "seatTypes": "IJOO",
            "chooseBedFlag": 0,
            "edwSeat": "无",
            "tostationno": "05",
            "ticketInfoVos": [    //票价信息
                {
                    "discountList": [    //折扣信息
                        {
                            "msg": "8.0折",
                            "sysCode": "14",
                            "outCode": "O",
                            "price": "359.0",
                            "seatTypeName": "二等座"
                        }
                    ],
                    "seatType": "14",
                    "discountMsg": "8.0折",
                    "price": "359.0",
                    "seatName": "二等座",
                    "desc": "无票"
                },
                {
                    "discountList": [
                        {
                            "msg": "8.0折",
                            "sysCode": "17",
                            "outCode": "W",
                            "price": "359.0",
                            "seatTypeName": "无座"
                        }
                    ],
                    "seatType": "17",
                    "discountMsg": "8.0折",
                    "price": "359.0",
                    "seatName": "无座",
                    "desc": "余4张"
                },
                {
                    "discountList": [
                        {
                            "msg": "8.0折",
                            "sysCode": "38",
                            "outCode": "I1",
                            "price": "772.0",
                            "seatTypeName": "一等卧下"
                        },
                        {
                            "msg": "8.0折",
                            "sysCode": "36",
                            "outCode": "I3",
                            "price": "682.0",
                            "seatTypeName": "一等卧上"
                        }
                    ],
                    "seatType": "32",
                    "discountMsg": "8.0折",
                    "price": "772.0",
                    "seatName": "一等卧",
                    "desc": "无票"
                },
                {
                    "discountList": [
                        {
                            "msg": "8.0折",
                            "sysCode": "41",
                            "outCode": "J1",
                            "price": "628.0",
                            "seatTypeName": "二等卧下"
                        },
                        {
                            "msg": "8.0折",
                            "sysCode": "40",
                            "outCode": "J2",
                            "price": "574.0",
                            "seatTypeName": "二等卧中"
                        },
                        {
                            "msg": "8.0折",
                            "sysCode": "39",
                            "outCode": "J3",
                            "price": "538.0",
                            "seatTypeName": "二等卧上"
                        }
                    ],
                    "seatType": "33",
                    "discountMsg": "8.0折",
                    "price": "628.0",
                    "seatName": "二等卧",
                    "desc": "无票"
                }
            ],
            "hardSeat": "",
            "firstSeat": "",
            "houbuTrainFlag": "1",
            "distanceTime": "12:03",
            "isStartStation": 1,
            "preSellTime": "0001-01-01 00:00:00"  //预售时间:0001-01-01 00:00:00(表示在售)
        }
    ]
}


详细参数文档说明,请联系客服!
                                                
 
©版权所有hangxx.com ICP备案号:渝ICP备2020011102号-2  渝公网安备 50010802005844号