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. 购票服务

购票接口v2

POST
/api/ticket-service/ticket/purchase/v2

请求参数

Header 参数
Authorization
string 
必需
示例值:
Bearer eyJhbGciOiJIUzUxMiJ9.eyJpYXQiOjE2ODk0MzQyNzQsImlzcyI6ImluZGV4MTIzMDYiLCJzdWIiOiJ7XCJyZWFsTmFtZVwiOlwi5bCP562J57GzXCIsXCJ1c2VySWRcIjpcIjE2NjYzNDc1NjA5MzM4NTExMzZcIixcInVzZXJuYW1lXCI6XCJtYWNoZW5cIn0iLCJleHAiOjE2ODk1MjA2NzR9.5BglexP_0fEUvc21stWZj6-2oGdkWCITP3uSokx_3eeLlmFgpFfdlAkWDrVdCoFBMHPa7PZ4bOdZ1lp4AeeTLQ
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/v2' \
--header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJpYXQiOjE2ODk0MzQyNzQsImlzcyI6ImluZGV4MTIzMDYiLCJzdWIiOiJ7XCJyZWFsTmFtZVwiOlwi5bCP562J57GzXCIsXCJ1c2VySWRcIjpcIjE2NjYzNDc1NjA5MzM4NTExMzZcIixcInVzZXJuYW1lXCI6XCJtYWNoZW5cIn0iLCJleHAiOjE2ODk1MjA2NzR9.5BglexP_0fEUvc21stWZj6-2oGdkWCITP3uSokx_3eeLlmFgpFfdlAkWDrVdCoFBMHPa7PZ4bOdZ1lp4AeeTLQ' \
--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
}
上一页
购票接口
下一页
购票接口v3
Built with