获取 12306 常用联系人

POST

/train/openapi/v4/12306/contacts

使用 12306 账号和密码读取常用联系人。仅适用于中国铁路场景；密码字段为敏感信息。

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

{
    "account": "zhangsan",
    "password": "ExamplePassword123"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/train/openapi/v4/12306/contacts' \
--header 'code: <api-key>' \
--header 'timestamp: <api-key>' \
--header 'signature: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "account": "zhangsan",
    "password": "ExamplePassword123"
}'

Responses

🟢200

application/json

查询成功。

Bodyapplication/json

Example

{
    "code": 0,
    "message": "Success",
    "data": [
        {
            "id": "123456",
            "address": "北京市",
            "birthday": "1990-01-01",
            "personType": 1,
            "phone": "138****8000",
            "name": "张三",
            "country": "CN",
            "tel": "",
            "isUserSelf": 1,
            "checkStatus": 0,
            "phoneCheckStatus": 0,
            "identyType": "1",
            "email": "user@example.com",
            "sex": 1,
            "identy": "110101********1234"
        }
    ]
}

🟢200TrainBusinessError

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

查询航班账户余额

获取 12306 支付表单