COST
扣费规则
items 表示本次响应实际返回的记录条数，按记录数计算后再应用最低扣费。
按本页返回条数计费，0.10 额度/条，向上取整，最低扣费额度为 1
实际扣费以响应头 x-api-cost 为准；请求失败时也可能触发最低扣费。
请求说明
参数
路径参数
trainCodestring 必填
要查询的车次号，例如 D2212。
示例：D2212
查询参数
startinteger
起始时间戳，单位秒，包含边界；留空表示从最早记录开始。
示例：1735689600
endinteger
结束时间戳，单位秒，包含边界；留空表示读到最新记录。
示例：1738367999
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
},
"start": {
"type": "integer | null"
},
"end": {
"type": "integer | null"
},
"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",
"serviceDate",
"timetableId",
"emuCode"
],
"properties": {
"id": {
"type": "string",
"required": true
},
"serviceDate": {
"type": "string",
"required": true
},
"timetableId": {
"type": "integer | null",
"required": true
},
"emuCode": {
"type": "string",
"required": true
}
}
}
}
}
}
}
},
"error": {
"type": "string",
"required": true
}
}
}示例响应
{
"ok": true,
"data": {
"trainCode": "D3319",
"start": null,
"end": null,
"cursor": "",
"limit": 2,
"nextCursor": "20260503:674558",
"items": [
{
"id": "674559",
"serviceDate": "20260503",
"timetableId": 2524,
"emuCode": "CRH1A-1156"
},
{
"id": "674558",
"serviceDate": "20260503",
"timetableId": 2524,
"emuCode": "CRH1A-1151"
}
]
},
"error": ""
}400
Invalid path or query parameters.
响应头
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": "trainCode 不能为空。",
"error": "invalid_param"
}