95306铁路API接口文档
1. 简介
95306铁路API接口是为了方便用户获取中国铁路相关信息而设计的开放接口。通过该接口，用户可以查询车次信息、余票情况、车站信息等。
本文档将详细介绍95306铁路API接口的使用方法和参数说明，帮助用户快速上手并正确使用该接口。
2. 接口列表
95306铁路API接口包括以下几个主要的功能模块：
•车次查询
•余票查询
•车站查询
•线路查询
•城市查询
下面将依次介绍每个功能模块的具体接口和参数。
2.1 车次查询
接口名称：/train/query/trainNo/{trainNo}
请求方式： GET
请求参数：
参数名
类型
是否必填
描述
trainNo
string
是
车次代号
date
string
否
出发日期
from
string
否
出发城市
to
string
否
到达城市
pageIndex
int
否
分页索引
返回结果：
{
    "status": "success",
    "data": {
        "trainNo": "G1234",
        "from": "北京",
        "to": "上海",
        "startTime": "08:00",
        "endTime": "12:00",
        "duration": "4小时",
        ...
    }
}
返回字段说明：
•status：请求状态，值为”success”或”error”
•data：返回的车次信息
•trainNo：车次代号
•from：出发城市
•to：到达城市
•startTime：出发时间
•endTime：到达时间
•duration：行程时长
接口名称：/train/query/station/{station}
请求方式： GET
请求参数：
参数名
类型
是否必填
描述
station
string
是
车站名
date
string
否
出发日期
pageIndex
int
否
百度api接口
分页索引
返回结果：
{
    "status": "success",
    "data": [
        {
            "trainNo": "G1234",
            "from": "北京",
            "to": "上海",
            ...
        },
        ...
    ]
}
返回字段说明：
与车次查询接口相同。
2.2 余票查询
接口名称：/ticket/query/trainNo/{trainNo}
请求方式： GET
请求参数：
与车次查询接口相同。
返回结果：
与车次查询接口相同。
接口名称：/ticket/query/station/{station}
请求方式： GET
请求参数：
与车次查询接口相同。
返回结果：
与车次查询接口相同。
2.3 车站查询
接口名称：/station/query/{station}
请求方式： GET
请求参数：
参数名
类型
是否必填
描述
station
string
是
车站名
返回结果：
{
    "status": "success",
    "data": {
        "name": "北京南站",
        "province": "北京",
        "city": "北京",
        ...
    }
}
返回字段说明：
•status：请求状态，值为”success”或”error”
•data：返回的车站信息
•name：车站名称
•province：所在省份
•city：所在城市
2.4 线路查询
接口名称：/line/query/{line}
请求方式： GET
请求参数：
参数名
类型
是否必填
描述
line
string
是
线路名
返回结果：
{
    "status": "success",
    "data": {
        "name": "京沪高铁",
        ...
    }
}
返回字段说明：
•status：请求状态，值为”success”或”error”
•data：返回的线路信息