增量同步城市

POST

/train/openapi/v4/sync/cities

合作方内部接口。按更新时间、上一页末尾代码和分页大小同步城市；首次全量同步时 lastSyncAt 和 lastCode 可传空字符串。

Request

Authorization

API Key

Add parameter in header

code

Example:

code: ********************

API Key

Add parameter in header

timestamp

Example:

timestamp: ********************

API Key

Add parameter in header

signature

Example:

signature: ********************

Body Params application/jsonRequired

Example

{
    "lastSyncAt": "2026-07-01T00:00:00Z",
    "lastCode": "BJS",
    "limit": 100
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/train/openapi/v4/sync/cities' \
--header 'code: <api-key>' \
--header 'timestamp: <api-key>' \
--header 'signature: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "lastSyncAt": "2026-07-01T00:00:00Z",
    "lastCode": "BJS",
    "limit": 100
}'

Responses

🟢200

application/json

同步成功。

Bodyapplication/json

Example

{
    "code": 0,
    "message": "Success",
    "data": {
        "nextSyncAt": "2026-07-15T10:00:00Z",
        "nextLastCode": "CNSHA",
        "hasMore": true,
        "data": [
            {
                "code": "CNBJS",
                "countryCode": "CN",
                "pinyin": "beijing",
                "name": {
                    "en": "Beijing South",
                    "zh-Hans": "北京南"
                },
                "deleted": false,
                "createdAt": "2020-01-01T00:00:00Z",
                "updatedAt": "2026-07-01T00:00:00Z"
            }
        ]
    }
}

🟢200TrainBusinessError

Modified at 2026-07-21 08:28:46

确认退票

增量同步车站