Incrementally Sync Cities

POST

https://apiv1.simplifly.tech/train/openapi/v4/sync/cities

Internal partner endpoint. Sync cities by update time, previous-page ending code, and page size. countryCode may restrict the country or region. Use empty lastSyncAt and lastCode for the first full sync.

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: ********************

Header Params

Body Params application/jsonRequired

Example

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

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://apiv1.simplifly.tech/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",
    "countryCode": "CN",
    "limit": 100
}'

Responses

🟢200

application/json

Synchronization completed.

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": "Beijing South"
                },
                "deleted": false,
                "createdAt": "2020-01-01T00:00:00Z",
                "updatedAt": "2026-07-01T00:00:00Z"
            }
        ]
    }
}

🟢200TrainBusinessError

Get Foreign Passport Verification Status

Incrementally Sync Stations