目前V2接口正在慢慢上新，地址、调用方式和格式都与V1有较大差异。V2会不定期更新并逐步补齐V1功能，请注意及时跟进。

RailGo 系列软件的设计理念是开放、现代与自由。有鉴于此，RailGo 的大部分数据都通过 API 数据服务对外开放。

您可以通过自动化程序访问 RailGo 数据，借此快速方便地实现获取和联动铁路信息。这些可以获取的数据，与 RailGo 应用内的在线查询保持一致。

V1 版本数据服务使用的是数据库缓存，即在服务器上有一个维护更加频繁的离线数据库。V2 版本去除了这一机制，直接连接 12306 服务器，所以时效性会好一些。
但是相应的，V2 版本的开销比较大，所以响应时间会稍慢，算上网络延迟的话大约需要 1 秒左右，因此请合理设置 timeout 等待时间。

使用限制

现阶段 API 不设置 key 要求，不设置显式限速。但是，我们对您使用 API 的场合有如下要求：

不得用于违反法律法规的用途。

不得用于商业用途。此处的商业用途，指的是将获得本 API 提供的部分或全部信息的服务置于付费前提之下，或者付费且最终目的为获取经济利益的服务内使用本 API 提供的部分或全部信息，例如抽成的抢票平台。

不得用于公开的接口中转服务。

在公开的软件服务或公开的自动生成信息（包括但不限于图片、文本）中使用来自本 API 的数据时，请您标注数据来源，并一并带上 RailGo 主站或数据服务文档的链接，置于显著位置。特别地，大学毕业设计等实验性使用不受此限制。

不设置显式限速并不代表您可以肆意抓取，因为您还是可能会被 CDN 屏蔽或封禁 IP。如果我们发现您在使用时违反了上面的三个不得，那么您的 IP 地址（或网段）也可能遭到长期封禁，请自重。

如果您想要大批量获取一手数据，那么您不应该派出爬虫抓取数据服务，而是应当直接自行部署 RailGo-Parser。

传参格式

通常情况下，传入所有接口的参数遵循以下规则：

boolean：可以接受的表示“是”的值包括1、true、True、yes；可以接受的表示“否”的值包括0、false、False、no；

日期：可以接受的格式包括 MMdd，MM.dd，MM-dd，yyyyMMdd，yyyy-MM-dd，yyyy.MM.dd 等格式，其中前三种默认为当前年份。

对一些概念的解释

I. 车次号与车次 ID

在 TMIS 系统内部，处理车次使用的是长的车次 ID，例如 24000000G10L，其中 24 代表维护该车次信息的部门，一般是车次始发站所在的资产公司/车务段；末位的 L 用于区分。

对于这个示例，代表京沪北京段。他和常规意义上的北京直属站有显著的区别，同站始发的车次还可能拥有北京、京津城际等维护方。

停靠站、担当公司等重要信息的变更会引起车次 ID 的变化。一个我们看到的车次号，例如 G1 ，可能会对应多个车次 ID，且不同车次 ID 拿到的信息可能会有所差异。

RailGo 在返回的数据中保留车次 ID，但是强烈建议您不要使用他作为（如果需要的话）存储主键，而应当仅用于和其他平台交互，以免碰上运行图调整时搞混乱。

另外，中国铁路现行的车次编码规则中有出现多个车次对应同一列车的情况（学名复车次），例如 G1202/1203 指代同一列车。这是因为车次号的奇偶兼具了判断上下行的功能。

单号车次距离北京越来越远，双号车次距离北京越来越近；如果车次运行方向发生了转变，单双号会邻近转换；如果到北京的距离全程都差不多，则以上海为基准点。
注意：复车次有可能不止两个。

通常情况下，复车次的任意一个车次都可以传入 API 中，但是在部分情况下有例外，具体会说明。

II. 同城车站与同地车站

RailGo 目前只能够提供到精确至地级市（直辖市、地区、省直辖县）的车站定位，然而这些行政区通常都比较大，如果用所属行政区来判断同城，有时会得到很离谱的结果。

例如，我想坐车前往重庆城区，如果按照行政区来算的话，武隆、万州北 等车站都是 重庆市 这一地区下的车站，但他们离我们认知上的重庆市显然非常遥远。

12306 人工维护了一个同城车站列表，比较准确的划定了“同一个城镇内”的车站的范围，比如上面这个例子中万州北的唯一同城车站是万州。

但是，出于为分析等目的提供方便的需要，RailGo 在提供 12306 版本的同城车站同时引入同地车站的概念，指的就是同属一个地级行政区的车站。

注意

RailGo 的所有数据都是自动采集的。由于上游可能会录入错误信息（对于 12306 这是家常事），我们不对数据服务的准确性作任何保证。

就像 RailGo 应用用户协议里写的一样，请不要使用数据服务的信息要求铁路运输企业做任何事。RailGo 的每一位开发者都不支持这种无理取闹的行径。

如果您需要使用我们的数据开展正式研究，建议您事先与我们取得联系。

联系方式

反馈 QQ 群：652032716 （入群答案请填写：文档站）

数据服务简介

目前V2接口正在慢慢上新，地址、调用方式和格式都与V1有较大差异。V2会不定期更新并逐步补齐V1功能，请注意及时跟进。#

使用限制#

传参格式#

对一些概念的解释#

I. 车次号与车次 ID#

II. 同城车站与同地车站#

注意#

联系方式#