DOCS

按车次分页读取历史时刻表清单

返回指定车次的历史时刻表覆盖范围列表。

总览私有部署数据抓取流程API 文档
返回 API 列表
get/api/v1/timetable/train/{trainCode}/history
可匿名访问api.timetable.train.history.read

COST

扣费规则

items 表示本次响应实际返回的记录条数，按记录数计算后再应用最低扣费。

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

实际扣费以响应头 x-api-cost 为准；请求失败时也可能触发最低扣费。

请求说明

参数

路径参数

trainCodestring 必填

要查询的车次号，例如 D2212。

示例：D2212

查询参数

limitinteger

正整数分页大小；当请求值超过服务端配置上限时，服务端会自动截断。

示例：20

cursorstring

分页游标。

示例：1741996800:1024

响应说明

状态码与响应格式

200

一页历史时刻表清单数据。

响应头

x-api-remainx-api-cost
application/jsonobject

响应结构 

{
    "type": "object",
    "required": [
        "ok",
        "data",
        "error"
    ],
    "properties": {
        "ok": {
            "type": "boolean",
            "required": true
        },
        "data": {
            "type": "object",
            "required": true,
            "shape": {
                "type": "object",
                "required": [
                    "trainCode",
                    "cursor",
                    "limit",
                    "nextCursor",
                    "items"
                ],
                "properties": {
                    "trainCode": {
                        "type": "string",
                        "required": true
                    },
                    "cursor": {
                        "type": "string",
                        "required": true
                    },
                    "limit": {
                        "type": "integer",
                        "required": true
                    },
                    "nextCursor": {
                        "type": "string",
                        "required": true
                    },
                    "items": {
                        "type": "array<object>",
                        "required": true,
                        "shape": {
                            "type": "array",
                            "items": {
                                "type": "object",
                                "required": [
                                    "id",
                                    "historyId",
                                    "serviceDateStart",
                                    "serviceDateEndExclusive"
                                ],
                                "properties": {
                                    "id": {
                                        "type": "integer",
                                        "required": true
                                    },
                                    "historyId": {
                                        "type": "integer",
                                        "required": true
                                    },
                                    "serviceDateStart": {
                                        "type": "string",
                                        "required": true
                                    },
                                    "serviceDateEndExclusive": {
                                        "type": "string",
                                        "required": true
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "error": {
            "type": "string",
            "required": true
        }
    }
}

示例响应 

{
    "ok": true,
    "data": {
        "trainCode": "G512",
        "cursor": "",
        "limit": 2,
        "nextCursor": "",
        "items": [
            {
                "id": 6845,
                "historyId": 5479,
                "serviceDateStart": "20260502",
                "serviceDateEndExclusive": "20260503"
            }
        ]
    },
    "error": ""
}
400

路径参数或分页参数无效。

响应头

x-api-remainx-api-cost
application/jsonobject

响应结构 

{
    "type": "object",
    "required": [
        "ok",
        "data",
        "error"
    ],
    "properties": {
        "ok": {
            "type": "boolean",
            "required": true
        },
        "data": {
            "type": "string",
            "required": true
        },
        "error": {
            "type": "string",
            "required": true
        }
    }
}

示例响应 

{
    "ok": false,
    "data": "cursor 必须是 \"serviceDate:id\" 格式",
    "error": "invalid_param"
}