12306
  1. 购票服务
12306
  • 用户服务
    • 用户接口
      • 用户登录
      • 检查用户是否登录
      • 用户退出登录
      • 用户名是否存在
      • 注册用户
      • 查询用户信息
      • 注销用户
      • 修改用户
    • 乘车人接口
      • 乘车人列表查询
      • 乘车人ID列表查询
      • 添加乘车人
      • 修改乘车人
      • 移除乘车人
  • 站点查询
    • 站点查询
      GET
    • 列车经停站查询
      GET
    • 查询全部车站
      GET
  • 购票服务
    • 查询购票信息
      GET
    • 购票接口
      POST
    • 购票接口v2
      POST
    • 购票接口v3
      POST
    • 重置座位状态
      POST
    • 查询支付单
      GET
    • 取消车票订单
      POST
    • 车票订单退款
      POST
  • 订单服务
    • 订单号查询订单
      GET
    • 分页查询订单
      GET
    • 下单接口
      POST
    • 本人车票
      GET
  • 支付服务
    • 支付接口
      POST
    • 订单号查询支付单
      GET
    • 支付单号查询支付单
      GET
  • 定时任务
    • 列车余量缓存初始化
      GET
    • 列车路线缓存初始化
      GET
    • 列车站点详缓存初始化
      GET
    • 地区站点查询缓存初始化
      GET
  1. 购票服务

购票接口

POST
/api/ticket-service/ticket/purchase

请求参数

Header 参数
Authorization
string 
必需
默认值:
Bearer eyJhbGciOiJIUzUxMiJ9.eyJpYXQiOjE3NDQwMDE0ODQsImlzcyI6ImluZGV4MTIzMDYiLCJzdWIiOiJ7XCJyZWFsTmFtZVwiOlwi5b6Q5LiH6YeMXCIsXCJ1c2VySWRcIjpcIjE2ODMwMjU1NTIzNjQ1Njg1NzZcIixcInVzZXJuYW1lXCI6XCJhZG1pblwifSIsImV4cCI6MTc0NDA4Nzg4NH0.MCFgur9QEsOtP6N07B0kFnokTMDtBO98OWB-Iwwh5qWAbr_Y-ufyyxoKE6uhNd4BthS9bHh_xQDxDYsjfObt4g
Body 参数application/json
trainId
string 
车次ID
必需
passengers
array [object {2}] 
乘车人ID集合
必需
passengerId
string 
乘车人ID
必需
seatType
string 
座位类型
必需
0:商务座 1:一等座 2:二等座 3:二等包座 4:一等卧 5:二等卧 6:软卧 7:硬卧 8:硬座 10:无座
seatType
string 
座位类型
必需
chooseSeats
array[string]
选择座位集合
必需
departure
string 
出发站点
必需
arrival
string 
到达站点
必需
示例
{
    "trainId": "2",
    "passengers": [
        {
            "passengerId": "1666343851196878848",
            "seatType": "0"
        },
        {
            "passengerId": "1666343166634420046496153651196878848",
            "seatType": "0"
        }
    ],
    "chooseSeats": [],
    "departure": "北京南",
    "arrival": "杭州东"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://127.0.0.1:9000/api/ticket-service/ticket/purchase' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "trainId": "2",
    "passengers": [
        {
            "passengerId": "1666343851196878848",
            "seatType": "0"
        },
        {
            "passengerId": "1666343166634420046496153651196878848",
            "seatType": "0"
        }
    ],
    "chooseSeats": [],
    "departure": "北京南",
    "arrival": "杭州东"
}'

返回响应

🟢200成功
application/json
Body
code
string 
必需
message
null 
必需
data
object 
必需
orderSn
string 
订单号
必需
ticketOrderDetails
array [object {8}] 
必需
requestId
null 
必需
success
boolean 
必需
示例
{
    "code": "0",
    "message": null,
    "data": {
        "orderSn": "1677929762971848704",
        "ticketOrderDetails": [
            {
                "seatType": 0,
                "carriageNumber": "01",
                "seatNumber": "01A",
                "realName": "马百万",
                "idType": 0,
                "idCard": "1234567890",
                "ticketType": 0,
                "amount": 231300
            },
            {
                "seatType": 0,
                "carriageNumber": "01",
                "seatNumber": "01F",
                "realName": "花花",
                "idType": 0,
                "idCard": "1234567890",
                "ticketType": 0,
                "amount": 231300
            }
        ]
    },
    "requestId": null,
    "success": true
}
上一页
查询购票信息
下一页
购票接口v2
Built with