Log in to 12306 - CTO OPEN API Document

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

or

Body Params application/jsonRequired

Example

{
    "loginType": "0",
    "userName": "zhangsan",
    "pwd": "ExamplePassword123",
    "notQueryPassenger": "0",
    "callBackURL": "https://buyer.example.com/callbacks/12306",
    "requestId": "req_12306_001"
}

Request Code Samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location '/train/openapi/v4/12306/login' \
--header 'code: <api-key>' \
--header 'timestamp: <api-key>' \
--header 'signature: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "loginType": "0",
    "userName": "zhangsan",
    "pwd": "ExamplePassword123",
    "notQueryPassenger": "0",
    "callBackURL": "https://buyer.example.com/callbacks/12306",
    "requestId": "req_12306_001"
}'

Responses

🟢200

application/json

Request completed. The 12306 login outcome is represented by data.state, data.code, and data.failMsg.

Bodyapplication/json

Example

{
    "code": 0,
    "message": "Success",
    "data": {
        "State": true,
        "Code": 0,
        "FailCode": "",
        "FailMsg": "",
        "UserName": "zhangsan",
        "UserNameIn12306": "Example",
        "MobileIn12306": "138****8000",
        "MemberActiveStatus": 1,
        "RequestID": "req_12306_001",
        "PassengerInfos": [
            {
                "PassengerIDType": "1",
                "PassengerName": "Example",
                "PassengerNo": "123456",
                "TicketType": "1",
                "PassengerStatus": 0,
                "PassengerCheckStatus": 0,
                "PassengerID": "110101********1234",
                "Mobile": "138****8000",
                "MobileAreaCode": "+86",
                "Country": "CN",
                "BornDate": "1990-01-01",
                "ExpireDate": "2030-01-01",
                "IsUserSelf": 1
            }
        ],
        "FactActions": [
            1
        ]
    }
}

🟢200TrainBusinessError