接口描述
通过输入出发车站编码,到达车站编码,查询日期,车票类型进行查询。
请求说明
接口域名
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 |
请求代码示例
提示一:使用示例代码前,请记得替换相应的参数值。
提示二:部分语言依赖的类或库,请在代码注释中查看下载地址。
#请先安装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": "查询成功" }