编辑 12306 乘客

POST

/train/openapi/v4/12306/edit-passenger

新增、修改或删除 12306 常用乘客。passengerDto 必传，其中姓名、证件号、证件类型和乘客类型必填。

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

{
    "userName": "zhangsan",
    "userPwd": "ExamplePassword123",
    "opType": 0,
    "requestId": "req_12306_001",
    "callBackURL": "https://buyer.example.com/callbacks/12306",
    "passengerDto": {
        "passengerId": "123456",
        "passengerName": "ZHANG SAN",
        "passengerIdNo": "E12345678",
        "passengerIdType": "B",
        "passengerType": "1",
        "mobile": "13800138000",
        "mobileAreaCode": "+86",
        "email": "passenger@example.com",
        "passengerIdBornDate": "1990-01-01",
        "passengerIdExpireDate": "2030-01-01",
        "country": "CN",
        "sex": "M"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/train/openapi/v4/12306/edit-passenger' \
--header 'code: <api-key>' \
--header 'timestamp: <api-key>' \
--header 'signature: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userName": "zhangsan",
    "userPwd": "ExamplePassword123",
    "opType": 0,
    "requestId": "req_12306_001",
    "callBackURL": "https://buyer.example.com/callbacks/12306",
    "passengerDto": {
        "passengerId": "123456",
        "passengerName": "ZHANG SAN",
        "passengerIdNo": "E12345678",
        "passengerIdType": "B",
        "passengerType": "1",
        "mobile": "13800138000",
        "mobileAreaCode": "+86",
        "email": "passenger@example.com",
        "passengerIdBornDate": "1990-01-01",
        "passengerIdExpireDate": "2030-01-01",
        "country": "CN",
        "sex": "M"
    }
}'

Responses

🟢200

application/json

调用成功。

Bodyapplication/json

Example

{
    "code": 0,
    "message": "Success",
    "data": {
        "State": true,
        "Code": 0,
        "FailMsg": ""
    }
}

🟢200TrainBusinessError

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

验证 12306 短信验证码

执行 12306 人脸核验