文档中心 > API类目 > 汽车票API

taobao.bus.seatprice.get (汽车票余票接口)

提供给商家，查询汽车票班次余票

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
top_query_seat_rq	TopQuerySeatRq	必须			查询参数
└ item_unique_key String 必须 827817551201061 唯一键

响应参数

名称	类型	示例值	描述
service_price	Number	200	服务费
price	Number	8000	票价单位分
dep_time	String	08:00	出发时间 HH:mm
stock	Number	30	库存
dep_date	String	2025-03-19	出发日期 yyyy-MM-dd
status	Number	1	状态
bus_number_id	String	129841026905121	班次id-短-仅作展示使用
half_price	Number	2000	半价票，单位分
bus_type	String	大巴车	车型
dep_std_station_name	String	南京火车站	出发车站名称
arr_std_station_name	String	杭州火车站	到达车站名称
item_unique_key	String	ITEM_UNIQUE_KEY_001	班次唯一键
route_key	String	ROUTE_KEY_001	routeKey
shift_type	Number	0	是否流水班（固定班次=0，流水班次=1）
last_dep_time	String	09:00	最晚发车时间，HH:mm
extra_schedule	Boolean	false	是否加班车
refund_rule	String	退票规则	jsong格式数据
refund_time	Number	30	开车前多少分钟可以退票-实际场景中可能值为负数
is_refund	Boolean	true	是否可退票
refund_mode	Number	1	退票模式 1：按单退 2 按票退
support_child	Boolean	true	是否支持儿童票
support_with_child	Boolean	false	是否支持携童票
with_child_stock	Number	12	携童票库存
support_ele_ticket	Boolean	true	是否支持携童票
max_sell_num	Number	5	一单最大售票数量
spend_time	String	50	耗时（单位分钟）
distance	Number	10	里程(单位：km)
result_code	String	SYS_ERROR	错误码
result_msg	String	系统异常	错误信息
is_success	Boolean	true	是否成功

请求示例

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
BusSeatpriceGetRequest req = new BusSeatpriceGetRequest();
BusSeatpriceGetRequest.TopQuerySeatRq obj1 = new BusSeatpriceGetRequest.TopQuerySeatRq();
obj1.setItemUniqueKey("827817551201061");
req.setTopQuerySeatRq(obj1);
BusSeatpriceGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

XML示例
JSON示例

<bus_seatprice_get_response>
    <service_price>200</service_price>
    <price>8000</price>
    <dep_time>08:00</dep_time>
    <stock>30</stock>
    <dep_date>2025-03-19</dep_date>
    <status>1</status>
    <bus_number_id>129841026905121</bus_number_id>
    <half_price>2000</half_price>
    <bus_type>大巴车</bus_type>
    <dep_std_station_name>南京火车站</dep_std_station_name>
    <arr_std_station_name>杭州火车站</arr_std_station_name>
    <item_unique_key>ITEM_UNIQUE_KEY_001</item_unique_key>
    <route_key>ROUTE_KEY_001</route_key>
    <shift_type>0</shift_type>
    <last_dep_time>09:00</last_dep_time>
    <extra_schedule>false</extra_schedule>
    <refund_rule>退票规则</refund_rule>
    <refund_time>30</refund_time>
    <is_refund>true</is_refund>
    <refund_mode>1</refund_mode>
    <support_child>true</support_child>
    <support_with_child>false</support_with_child>
    <with_child_stock>12</with_child_stock>
    <support_ele_ticket>true</support_ele_ticket>
    <max_sell_num>5</max_sell_num>
    <spend_time>50</spend_time>
    <distance>10</distance>
    <result_code>SYS_ERROR</result_code>
    <result_msg>系统异常</result_msg>
    <is_success>true</is_success>
</bus_seatprice_get_response>

异常示例

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码	错误描述	解决方案

API工具

API测试工具错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问

返回
顶部