DOCS

API 文档

这套文档由仓库内维护的 OpenAPI 元数据驱动，包括鉴权接口、车次车组历史查询和每日数据导出。

总览私有部署数据抓取流程API 文档

BASE PATH

所有 API 接口都以

/api/v1

作为基础路径。

AUTH

除鉴权和每日数据导出外其他接口都允许匿名访问和使用 API Key 访问。请打开用户页，切换选项卡至“开发”页，轻击“签发”按钮以获取您的 API Key。

API Key 请求头：authorization

API TOKEN

每次响应都可能通过响应头返回剩余额度、请求耗额和重试等待时间。 请注意的是，由于大部分查询接口都使用了 Cloudflare 的缓存层，具体配额使用情况请以鉴权接口返回的结果为准。

x-api-remain

x-api-cost

Retry-After

AGREEMENT

统一响应结构

成功的 JSON 响应统一使用 ok、data、error 这层包装；支持分页的查询接口还会额外使用 limit 和 cursor。 

{
    "ok": true,
    "data": {},
    "error": ""
}

历史

查询车次和车组的担当历史。

get/api/v1/history/emu/{emuCode}

按车组查询历史

返回单个车组的历史担当记录。

可匿名访问api.history.emu.read

扣费规则：按本页返回条数计费，0.05 额度/条，向上取整，最低扣费额度为 1

get/api/v1/history/train/{trainCode}

按车次查询历史

返回单个车次的历史车底记录。

可匿名访问api.history.train.read

扣费规则：按本页返回条数计费，0.05 额度/条，向上取整，最低扣费额度为 1

导出

列出并下载已生成的每日数据导出文件。

get/api/v1/exports/daily/{date}

读取单日导出文件

读取某日已生成的车次车底对应关系导出文件；开启 binary 模式时返回原始文本，否则返回 JSON 包裹结构。

可匿名访问api.exports.daily.read

扣费规则：固定 50 点额度/次

get/api/v1/exports/daily

列出可用的日导出文件

按年和月列出已生成的日导出文件。

可匿名访问api.exports.daily.read

扣费规则：固定 2 点额度/次

时刻表

读取当前日期下的完整车次时刻表。

get/api/v1/timetable/station/{stationName}

按车站读取当日站内时刻表

返回指定车站的计划车次列表，按列车到站时间升序排序。

可匿名访问api.timetable.station.read

扣费规则：按本页返回条数计费，0.05 额度/条，向上取整，最低扣费额度为 1

get/api/v1/timetable/train/{trainCode}

按车次读取当前完整时刻表

返回该车次的时刻表，包括经停站、当前站车次、检票口信息和参考车型。

可匿名访问api.timetable.train.read

扣费规则：固定 1 点额度/次

记录

分页读取每日运行记录。

get/api/v1/records/daily

分页读取每日记录

读取该日的车次车组担当记录。

可匿名访问api.records.daily.read

扣费规则：按本页返回条数计费，0.05 额度/条，向上取整，最低扣费额度为 1

身份

查看当前鉴权会话的信息。

get/api/v1/auth/me

读取当前鉴权会话

返回当前用户、正在使用的 API Key 摘要以及当前额度桶状态。

api.auth.me.read

扣费规则：固定 1 点额度/次