DOCS

分页读取每日记录

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

总览私有部署数据抓取流程OAuth 文档API 文档
返回 API 列表
get/api/v1/records/daily
可匿名访问api.records.daily.read

COST

扣费规则

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

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

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

请求说明

参数

查询参数

datestring 必填

日期，格式为 YYYYMMDD。

示例：584020730

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": [
                    "date",
                    "cursor",
                    "limit",
                    "nextCursor",
                    "items"
                ],
                "properties": {
                    "date": {
                        "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",
                                    "serviceDate",
                                    "timetableId",
                                    "emuCode",
                                    "trainCode"
                                ],
                                "properties": {
                                    "id": {
                                        "type": "string",
                                        "required": true
                                    },
                                    "serviceDate": {
                                        "type": "string",
                                        "required": true
                                    },
                                    "timetableId": {
                                        "type": "integer | null",
                                        "required": true
                                    },
                                    "emuCode": {
                                        "type": "string",
                                        "required": true
                                    },
                                    "trainCode": {
                                        "type": "string",
                                        "required": true
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "error": {
            "type": "string",
            "required": true
        }
    }
}

示例响应 

{
    "ok": true,
    "data": {
        "date": "20260503",
        "cursor": "",
        "limit": 2,
        "nextCursor": "20260503:681106",
        "items": [
            {
                "id": "681107",
                "serviceDate": "20260503",
                "timetableId": 5096,
                "emuCode": "CRH380A-2844",
                "trainCode": "C9607"
            },
            {
                "id": "681106",
                "serviceDate": "20260503",
                "timetableId": 5096,
                "emuCode": "CRH380A-2844",
                "trainCode": "C9606"
            }
        ]
    },
    "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": "date 必须使用 YYYYMMDD 格式。",
    "error": "invalid_param"
}