获取始发站-终点站的车票信息,含获取车次、票价、经停站、余票数量等信息。
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| key | string | 是 | 接口调用密钥 | |
| from | string | 是 | 出发站点或城市名称,可模糊输入 | 宁波 |
| to | string | 是 | 终点站站点或城市名称,可模糊输入 | 贵阳 |
| date | datetime | 否 | 出发日期,yyyyMMdd 或 yyyy-MM-dd,默认今天(仅今天起 15 天内) | 20261119 |
[
{
"name": "key",
"type": "string",
"required": true,
"description": "接口调用密钥",
"example": ""
},
{
"name": "from",
"type": "string",
"required": true,
"description": "出发站点或城市名称,可模糊输入",
"example": "宁波"
},
{
"name": "to",
"type": "string",
"required": true,
"description": "终点站站点或城市名称,可模糊输入",
"example": "贵阳"
},
{
"name": "date",
"type": "datetime",
"required": false,
"description": "出发日期,yyyyMMdd 或 yyyy-MM-dd,默认今天(仅今天起 15 天内)",
"example": "20261119"
}
]
{
"openapi": "3.1.1",
"info": {
"title": "动车车票信息",
"description": "获取始发站-终点站的车票信息,含获取车次、票价、经停站、余票数量等信息。",
"version": "1.0.0"
},
"paths": {
"/v1/12306_cp": {
"get": {
"summary": "动车车票信息",
"description": "获取始发站-终点站的车票信息,含获取车次、票价、经停站、余票数量等信息。",
"parameters": [
{
"name": "key",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "接口调用密钥"
},
{
"name": "from",
"in": "query",
"required": true,
"schema": {
"type": "string",
"example": "宁波"
},
"description": "出发站点或城市名称,可模糊输入"
},
{
"name": "to",
"in": "query",
"required": true,
"schema": {
"type": "string",
"example": "贵阳"
},
"description": "终点站站点或城市名称,可模糊输入"
},
{
"name": "date",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "20261119"
},
"description": "出发日期,yyyyMMdd 或 yyyy-MM-dd,默认今天(仅今天起 15 天内)"
}
],
"responses": {
"200": {
"description": "成功",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
}
}
},
"post": {
"summary": "动车车票信息",
"description": "获取始发站-终点站的车票信息,含获取车次、票价、经停站、余票数量等信息。",
"parameters": [
{
"name": "key",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "接口调用密钥"
},
{
"name": "from",
"in": "query",
"required": true,
"schema": {
"type": "string",
"example": "宁波"
},
"description": "出发站点或城市名称,可模糊输入"
},
{
"name": "to",
"in": "query",
"required": true,
"schema": {
"type": "string",
"example": "贵阳"
},
"description": "终点站站点或城市名称,可模糊输入"
},
{
"name": "date",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "20261119"
},
"description": "出发日期,yyyyMMdd 或 yyyy-MM-dd,默认今天(仅今天起 15 天内)"
}
],
"responses": {
"200": {
"description": "成功",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
}
}
}
}
},
"servers": [
{
"url": "https://api.suol.cc",
"description": "当前访问入口(https)"
}
]
}
{
"ok": true,
"fetchedAt": "2026-11-18T16:56:41+08:00",
"cached": false,
"query": {
"from": {
"input": "宁波",
"code": "NGH",
"name": "宁波",
"city": "宁波市"
},
"to": {
"input": "贵阳北",
"code": "KQW",
"name": "贵阳北",
"city": "贵阳市"
},
"date": "2026-11-19",
"dateCode": "20261119",
"purpose": "ADULT",
"strict": false,
"stops": true
},
"count": 3,
"trains": [
{
"trainCode": "G2332",
"trainNo": "5j000G233202",
"trainType": "G",
"from": {
"code": "NGH",
"name": "宁波",
"stationNo": "03",
"isOrigin": false,
"stopType": "过"
},
"to": {
"code": "KQW",
"name": "贵阳北",
"stationNo": "23",
"isTerminus": false,
"stopType": "过"
},
"startStation": "宁海",
"endStation": "兴义南",
"startTime": "07:47",
"arriveTime": "17:31",
"duration": "09:44",
"durationMinutes": 584,
"arriveDayOffset": 0,
"canBuy": "Y",
"buttonText": "预订",
"houbuSupported": true,
"isSleeper": false,
"tags": [
"静",
"敬"
],
"serviceFlags": "Q0210##0#1",
"priceFrom": 819,
"priceFromText": "¥819起",
"seats": [
{
"name": "商务座",
"value": "无",
"available": false,
"statusText": "候补",
"price": 2567
},
{
"name": "一等座",
"value": "无",
"available": false,
"statusText": "候补",
"price": 1311
},
{
"name": "二等座",
"value": "无",
"available": false,
"statusText": "候补",
"price": 819
},
{
"name": "无座",
"value": "有",
"available": true,
"statusText": "有票",
"price": null
}
],
"seatTypes": [
"商务座",
"一等座",
"二等座"
],
"hasTicket": true,
"trainDate": "20261119",
"stops": [
{
"stationNo": 3,
"name": "宁波",
"arriveTime": "07:45",
"departTime": "07:47",
"stopover": "2分钟",
"isEnabled": true
},
{
"stationNo": 4,
"name": "余姚北",
"arriveTime": "08:08",
"departTime": "08:12",
"stopover": "4分钟",
"isEnabled": true
},
{
"stationNo": 5,
"name": "绍兴东",
"arriveTime": "08:23",
"departTime": "08:25",
"stopover": "2分钟",
"isEnabled": true
},
{
"stationNo": 6,
"name": "绍兴北",
"arriveTime": "08:37",
"departTime": "08:40",
"stopover": "3分钟",
"isEnabled": true
},
{
"stationNo": 7,
"name": "杭州南",
"arriveTime": "08:52",
"departTime": "09:10",
"stopover": "18分钟",
"isEnabled": true
},
{
"stationNo": 8,
"name": "义乌",
"arriveTime": "09:39",
"departTime": "09:41",
"stopover": "2分钟",
"isEnabled": true
},
{
"stationNo": 9,
"name": "金华",
"arriveTime": "09:58",
"departTime": "10:03",
"stopover": "5分钟",
"isEnabled": true
},
{
"stationNo": 10,
"name": "衢州",
"arriveTime": "10:24",
"departTime": "10:26",
"stopover": "2分钟",
"isEnabled": true
},
{
"stationNo": 11,
"name": "弋阳",
"arriveTime": "11:06",
"departTime": "11:12",
"stopover": "6分钟",
"isEnabled": true
},
{
"stationNo": 12,
"name": "鹰潭北",
"arriveTime": "11:26",
"departTime": "11:32",
"stopover": "6分钟",
"isEnabled": true
},
{
"stationNo": 13,
"name": "进贤南",
"arriveTime": "11:54",
"departTime": "11:56",
"stopover": "2分钟",
"isEnabled": true
},
{
"stationNo": 14,
"name": "南昌西",
"arriveTime": "12:15",
"departTime": "12:20",
"stopover": "5分钟",
"isEnabled": true
},
{
"stationNo": 15,
"name": "宜春",
"arriveTime": "13:02",
"departTime": "13:04",
"stopover": "2分钟",
"isEnabled": true
},
{
"stationNo": 16,
"name": "萍乡北",
"arriveTime": "13:22",
"departTime": "13:24",
"stopover": "2分钟",
"isEnabled": true
},
{
"stationNo": 17,
"name": "长沙南",
"arriveTime": "13:54",
"departTime": "14:03",
"stopover": "9分钟",
"isEnabled": true
},
{
"stationNo": 18,
"name": "湘潭北",
"arriveTime": "14:17",
"departTime": "14:23",
"stopover": "6分钟",
"isEnabled": true
},
{
"stationNo": 19,
"name": "韶山南",
"arriveTime": "14:37",
"departTime": "14:39",
"stopover": "2分钟",
"isEnabled": true
},
{
"stationNo": 20,
"name": "娄底南",
"arriveTime": "14:56",
"departTime": "14:58",
"stopover": "2分钟",
"isEnabled": true
},
{
"stationNo": 21,
"name": "怀化南",
"arriveTime": "15:50",
"departTime": "15:55",
"stopover": "5分钟",
"isEnabled": true
},
{
"stationNo": 22,
"name": "凯里南",
"arriveTime": "16:54",
"departTime": "16:56",
"stopover": "2分钟",
"isEnabled": true
},
{
"stationNo": 23,
"name": "贵阳北",
"arriveTime": "17:31",
"departTime": "17:36",
"stopover": "5分钟",
"isEnabled": true
}
],
"stopsCount": 21,
"stopsSource": "app"
},
{
"trainCode": "G2363",
"trainNo": "5e000G236304",
"trainType": "G",
"from": {
"code": "NGH",
"name": "宁波",
"stationNo": "01",
"isOrigin": true,
"stopType": "始"
},
"to": {
"code": "KQW",
"name": "贵阳北",
"stationNo": "20",
"isTerminus": true,
"stopType": "终"
},
"startStation": "宁波",
"endStation": "贵阳北",
"startTime": "09:13",
"arriveTime": "20:15",
"duration": "11:02",
"durationMinutes": 662,
"arriveDayOffset": 0,
"canBuy": "Y",
"buttonText": "预订",
"houbuSupported": true,
"isSleeper": false,
"tags": [
"静",
"敬"
],
"serviceFlags": "Q02##0#1",
"priceFrom": 832,
"priceFromText": "¥832起",
"seats": [
{
"name": "商务座",
"value": "1",
"available": true,
"statusText": "1张",
"price": 2565.5
},
{
"name": "一等座",
"value": "无",
"available": false,
"statusText": "候补",
"price": 1329.5
},
{
"name": "二等座",
"value": "15",
"available": true,
"statusText": "15张",
"price": 832
},
{
"name": "无座",
"value": "有",
"available": true,
"statusText": "有票",
"price": null
}
],
"seatTypes": [
"商务座",
"一等座",
"二等座"
],
"hasTicket": true,
"trainDate": "20261119",
"stops": [
{
"stationNo": 1,
"name": "宁波",
"arriveTime": "",
"departTime": "09:13",
"stopover": "",
"isEnabled": true
},
{
"stationNo": 2,
"name": "三门县",
"arriveTime": "09:52",
"departTime": "09:54",
"stopover": "2分钟",
"isEnabled": true
},
{
"stationNo": 3,
"name": "台州西",
"arriveTime": "10:13",
"departTime": "10:15",
"stopover": "2分钟",
"isEnabled": true
},
{
"stationNo": 4,
"name": "乐清",
"arriveTime": "10:46",
"departTime": "10:55",
"stopover": "9分钟",
"isEnabled": true
},
{
"stationNo": 5,
"name": "温州南",
"arriveTime": "11:13",
"departTime": "11:30",
"stopover": "17分钟",
"isEnabled": true
},
{
"stationNo": 6,
"name": "丽水",
"arriveTime": "12:04",
"departTime": "12:06",
"stopover": "2分钟",
"isEnabled": true
},
{
"stationNo": 7,
"name": "缙云西",
"arriveTime": "12:19",
"departTime": "12:21",
"stopover": "2分钟",
"isEnabled": true
},
{
"stationNo": 8,
"name": "金华",
"arriveTime": "12:55",
"departTime": "12:57",
"stopover": "2分钟",
"isEnabled": true
},
{
"stationNo": 9,
"name": "衢州",
"arriveTime": "13:18",
"departTime": "13:20",
"stopover": "2分钟",
"isEnabled": true
},
{
"stationNo": 10,
"name": "上饶",
"arriveTime": "13:47",
"departTime": "13:56",
"stopover": "9分钟",
"isEnabled": true
},
{
"stationNo": 11,
"name": "鹰潭北",
"arriveTime": "14:22",
"departTime": "14:28",
"stopover": "6分钟",
"isEnabled": true
},
{
"stationNo": 12,
"name": "南昌西",
"arriveTime": "15:04",
"departTime": "15:09",
"stopover": "5分钟",
"isEnabled": true
},
{
"stationNo": 13,
"name": "宜春",
"arriveTime": "15:51",
"departTime": "15:54",
"stopover": "3分钟",
"isEnabled": true
},
{
"stationNo": 14,
"name": "萍乡北",
"arriveTime": "16:12",
"departTime": "16:15",
"stopover": "3分钟",
"isEnabled": true
},
{
"stationNo": 15,
"name": "长沙南",
"arriveTime": "16:45",
"departTime": "16:55",
"stopover": "10分钟",
"isEnabled": true
},
{
"stationNo": 16,
"name": "娄底南",
"arriveTime": "17:31",
"departTime": "17:33",
"stopover": "2分钟",
"isEnabled": true
},
{
"stationNo": 17,
"name": "新化南",
"arriveTime": "17:58",
"departTime": "18:00",
"stopover": "2分钟",
"isEnabled": true
},
{
"stationNo": 18,
"name": "怀化南",
"arriveTime": "18:33",
"departTime": "18:37",
"stopover": "4分钟",
"isEnabled": true
},
{
"stationNo": 19,
"name": "凯里南",
"arriveTime": "19:37",
"departTime": "19:39",
"stopover": "2分钟",
"isEnabled": true
},
{
"stationNo": 20,
"name": "贵阳北",
"arriveTime": "20:15",
"departTime": "20:15",
"stopover": "",
"isEnabled": true
}
],
"stopsCount": 20,
"stopsSource": "app"
},
{
"trainCode": "K848",
"trainNo": "5e0000K84805",
"trainType": "K",
"from": {
"code": "NGH",
"name": "宁波",
"stationNo": "01",
"isOrigin": true,
"stopType": "始"
},
"to": {
"code": "GIW",
"name": "贵阳",
"stationNo": "17",
"isTerminus": true,
"stopType": "终"
},
"startStation": "宁波",
"endStation": "贵阳",
"startTime": "10:56",
"arriveTime": "13:14",
"duration": "26:18",
"durationMinutes": 1578,
"arriveDayOffset": 1,
"canBuy": "Y",
"buttonText": "预订",
"houbuSupported": false,
"isSleeper": true,
"tags": [
"铺"
],
"serviceFlags": "0##0#2",
"priceFrom": 224,
"priceFromText": "¥224起",
"seats": [
{
"name": "软卧",
"value": "20",
"available": true,
"statusText": "20张",
"price": 598
},
{
"name": "硬卧",
"value": "有",
"available": true,
"statusText": "有票",
"price": 381
},
{
"name": "硬座",
"value": "有",
"available": true,
"statusText": "有票",
"price": 224
},
{
"name": "无座",
"value": "有",
"available": true,
"statusText": "有票",
"price": null
}
],
"seatTypes": [
"硬卧",
"软卧",
"硬座"
],
"hasTicket": true,
"trainDate": "20261119",
"stops": [
{
"stationNo": 1,
"name": "宁波",
"arriveTime": "",
"departTime": "10:56",
"stopover": "",
"isEnabled": true
},
{
"stationNo": 2,
"name": "余姚",
"arriveTime": "11:36",
"departTime": "11:42",
"stopover": "6分钟",
"isEnabled": true
},
{
"stationNo": 3,
"name": "上虞",
"arriveTime": "12:06",
"departTime": "12:10",
"stopover": "4分钟",
"isEnabled": true
},
{
"stationNo": 4,
"name": "绍兴",
"arriveTime": "12:32",
"departTime": "12:36",
"stopover": "4分钟",
"isEnabled": true
},
{
"stationNo": 5,
"name": "义乌",
"arriveTime": "14:10",
"departTime": "14:14",
"stopover": "4分钟",
"isEnabled": true
},
{
"stationNo": 6,
"name": "金华",
"arriveTime": "14:53",
"departTime": "14:59",
"stopover": "6分钟",
"isEnabled": true
},
{
"stationNo": 7,
"name": "龙游",
"arriveTime": "15:31",
"departTime": "15:40",
"stopover": "9分钟",
"isEnabled": true
},
{
"stationNo": 8,
"name": "衢州",
"arriveTime": "16:02",
"departTime": "16:07",
"stopover": "5分钟",
"isEnabled": true
},
{
"stationNo": 9,
"name": "上饶",
"arriveTime": "18:02",
"departTime": "18:08",
"stopover": "6分钟",
"isEnabled": true
},
{
"stationNo": 10,
"name": "鹰潭",
"arriveTime": "19:16",
"departTime": "19:23",
"stopover": "7分钟",
"isEnabled": true
},
{
"stationNo": 11,
"name": "东乡",
"arriveTime": "19:50",
"departTime": "19:54",
"stopover": "4分钟",
"isEnabled": true
},
{
"stationNo": 12,
"name": "新余",
"arriveTime": "21:52",
"departTime": "21:57",
"stopover": "5分钟",
"isEnabled": true
},
{
"stationNo": 13,
"name": "宜春",
"arriveTime": "22:31",
"departTime": "22:36",
"stopover": "5分钟",
"isEnabled": true
},
{
"stationNo": 14,
"name": "怀化",
"arriveTime": "06:23",
"departTime": "06:34",
"stopover": "11分钟",
"isEnabled": true
},
{
"stationNo": 15,
"name": "凯里",
"arriveTime": "10:40",
"departTime": "10:44",
"stopover": "4分钟",
"isEnabled": true
},
{
"stationNo": 16,
"name": "贵定",
"arriveTime": "12:07",
"departTime": "12:11",
"stopover": "4分钟",
"isEnabled": true
},
{
"stationNo": 17,
"name": "贵阳",
"arriveTime": "13:14",
"departTime": "13:14",
"stopover": "",
"isEnabled": true
}
],
"stopsCount": 17,
"stopsSource": "app"
}
],
"stale": false,
"staleSeconds": 0,
"notice": ""
}
暂无详细文档
暂无代码示例。管理员可在后台用 AI 生成或手动编写。
// 结果将在此处显示
生效日期:2026年7月22日
欢迎使用 xiaoapi.cn(以下简称"本平台")。在使用本平台提供的 API 服务(以下简称"本服务")前,请务必仔细阅读并充分理解本免责声明。您以任何方式调用、访问或使用本服务,即视为您已阅读、理解并同意接受本声明的全部内容。
本平台作为 API 技术服务的提供方,仅提供技术接口与数据分发服务。本声明的目的在于明确平台与用户之间的责任边界,督促用户合法、合规地使用本服务,防范违法违规行为的发生。
用户在使用本服务时,明确禁止从事以下行为:
在法律法规允许的最大范围内,本平台对以下情形不承担责任:
因用户违反本声明或相关法律法规,导致本平台及其关联方、合作方遭受任何损失(包括但不限于赔偿款、罚款、律师费、诉讼费等),用户同意向本平台及相关方承担全部赔偿责任。
本平台有权根据法律法规变化、业务调整或监管要求,随时修改本声明。修改后的声明将在本页面公布,自公布之日起生效。您继续使用本服务,即视为接受更新后的声明。
如您对本声明有任何疑问,或发现他人存在违规使用本服务的行为,欢迎通过本平台公示的联系方式与我们联系,我们将及时处理。