淘宝开放平台 - 文档中心

请求地址：

环境	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_item_rq	TopQueryItemRq	必须			查询班次参数
└ city_name String 必须杭州市城市名称 └ city_code Number 必须 100100 城市code └ route_keys String [] 必须 cb1748b7cfaeb2055102a8ce88c4fa60 routeKeys列表，在查询路线接口中返回 └ dep_date String 必须 2025-03-10 出发日期，格式yyyy-MM-dd

名称	类型	示例值	描述
bus_item_infos	BusItemInfos []		busItemInfos
└ dep_std_province_name String 上海市出发省份名称 └ arr_std_station_code String NJ_STATION_CODE_001 到达车站code └ biz_type Number 5 业务类型 └ check_ticket_type String 电子票检票方式 └ route_key String ROUTE_KEY_001 routeKey └ obtain_ticket_type String 自助取票机取票方式 └ station_start_time String 07:00 车站营业开始时间 └ dep_date String 2023-09-01T00:00:00Z 出发日期 └ dep_std_area_name String 上海市中心出发区域名称 └ pre_sell_day Number 7 提前购票天数-预售期 └ arr_std_area_code Number 320100 到达区域code └ price Number 200 票价 └ refund_rule String 退票规则A 退改规则 └ transfer_mode Number 0 中转类型 0普通 1中转 └ dep_std_city_name String 上海出发城市名称 └ bus_type String 大型客车车型 └ stock Number 50 库存 └ station_end_time String 23:00 车站营业结束时间 └ arr_std_station_name String 南京火车站到达车站名称 └ arr_display_name String 南京到达到达展示名称 └ arr_std_province_name String 江苏省到达省份名称 └ dep_std_city_code Number 310000 出发城市code └ parent_route_key String PARENT_ROUTE_KEY_001 parentRouteKey └ item_unique_key String ITEM_UNIQUE_KEY_001 班次唯一键 └ shift_type Number 0 是否流水班（固定班次=0，流水班次=1） └ arr_std_city_code Number 320000 到达城市code └ dep_time String 2023-09-01T08:00:00Z 出发时间 └ refund_time Number 30 在线可退票时间，单位分钟 └ dep_std_station_name String 上海火车站出发车站名称 └ support_child Boolean true 是否支持儿童票 └ last_dep_time String 2023-09-01T09:00:00Z 最晚发车时间 └ support_with_child Boolean false 是否支持携童票 └ agent_route_id Number 10001 路线id └ arr_std_area_name String 南京市中心到达区域名称 └ service_price Number 20 服务费 └ dep_std_station_code String SH_STATION_CODE_001 出发车站code └ dep_std_area_code Number 310100 出发区域code └ is_refund Number 1 是否可退，0-不可退，1-可退 └ arr_std_city_name String 南京到达城市名称 └ refund_mode Number 1 退票模式 1：整单退 2 按票退 └ dep_display_name String 上海出发出发展示名称 └ extra_schedule Boolean false 是否加班车 └ pre_sell_time Number 60 提前购票时间，单位分钟 └ arr_time String 2023-09-01T12:00:00Z 到达时间 └ spend_time String 120 耗时（单位分钟） └ status Number 1 售卖状态 └ bus_number_id String busNumberUUID 班次id-短-仅作展示使用 └ half_price Number 20 半价票，单位分 └ distance Number 30 里程(单位千米) └ with_child_stock Number 3 携童票库存 └ support_ele_ticket Boolean true 是否支持电子票
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);
BusNumberGetRequest req = new BusNumberGetRequest();
BusNumberGetRequest.TopQueryItemRq obj1 = new BusNumberGetRequest.TopQueryItemRq();
obj1.setCityName("杭州市");
obj1.setCityCode(100100L);
obj1.setRouteKeys("cb1748b7cfaeb2055102a8ce88c4fa60");
obj1.setDepDate("2025-03-10");
req.setTopQueryItemRq(obj1);
BusNumberGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
BusNumberGetRequest req = new BusNumberGetRequest();
BusNumberGetRequest.TopQueryItemRqDomain obj1 = new BusNumberGetRequest.TopQueryItemRqDomain();
obj1.CityName = "杭州市";
obj1.CityCode = 100100L;
obj1.RouteKeys = "cb1748b7cfaeb2055102a8ce88c4fa60";
obj1.DepDate = "2025-03-10";
req.TopQueryItemRq_ = obj1;
BusNumberGetResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new BusNumberGetRequest;
$top_query_item_rq = new TopQueryItemRq;
$top_query_item_rq->city_name="杭州市";
$top_query_item_rq->city_code="100100";
$top_query_item_rq->route_keys="cb1748b7cfaeb2055102a8ce88c4fa60";
$top_query_item_rq->dep_date="2025-03-10";
$req->setTopQueryItemRq(json_encode($top_query_item_rq));
$resp = $c->execute($req, $sessionKey);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=taobao.bus.number.get' \
-d 'partner_id=apidoc' \
-d 'session=8d2ec331-99ce-4157-b41a-b1f5c905861c' \
-d 'sign=43D9696B6F3BAD551BD5D103806424BB' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-29+18%3A25%3A55' \
-d 'v=2.0' \
-d 'top_query_item_rq=null'

# -*- coding: utf-8 -*-
import top.api

req=top.api.BusNumberGetRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.top_query_item_rq="数据结构示例JSON格式"
try:
	resp= req.getResponse(sessionkey)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"taobao.bus.number.get");
add_param(pRequest,"top_query_item_rq","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('taobao.bus.number.get', {
	'top_query_item_rq':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<bus_number_get_response>
    <bus_item_infos>
        <bus_item_infos>
            <dep_std_province_name>上海市</dep_std_province_name>
            <arr_std_station_code>NJ_STATION_CODE_001</arr_std_station_code>
            <biz_type>5</biz_type>
            <check_ticket_type>电子票</check_ticket_type>
            <route_key>ROUTE_KEY_001</route_key>
            <obtain_ticket_type>自助取票机</obtain_ticket_type>
            <station_start_time>07:00</station_start_time>
            <dep_date>2023-09-01T00:00:00Z</dep_date>
            <dep_std_area_name>上海市中心</dep_std_area_name>
            <pre_sell_day>7</pre_sell_day>
            <arr_std_area_code>320100</arr_std_area_code>
            <price>200</price>
            <refund_rule>退票规则A</refund_rule>
            <transfer_mode>0</transfer_mode>
            <dep_std_city_name>上海</dep_std_city_name>
            <bus_type>大型客车</bus_type>
            <stock>50</stock>
            <station_end_time>23:00</station_end_time>
            <arr_std_station_name>南京火车站</arr_std_station_name>
            <arr_display_name>南京到达</arr_display_name>
            <arr_std_province_name>江苏省</arr_std_province_name>
            <dep_std_city_code>310000</dep_std_city_code>
            <parent_route_key>PARENT_ROUTE_KEY_001</parent_route_key>
            <item_unique_key>ITEM_UNIQUE_KEY_001</item_unique_key>
            <shift_type>0</shift_type>
            <arr_std_city_code>320000</arr_std_city_code>
            <dep_time>2023-09-01T08:00:00Z</dep_time>
            <refund_time>30</refund_time>
            <dep_std_station_name>上海火车站</dep_std_station_name>
            <support_child>true</support_child>
            <last_dep_time>2023-09-01T09:00:00Z</last_dep_time>
            <support_with_child>false</support_with_child>
            <agent_route_id>10001</agent_route_id>
            <arr_std_area_name>南京市中心</arr_std_area_name>
            <service_price>20</service_price>
            <dep_std_station_code>SH_STATION_CODE_001</dep_std_station_code>
            <dep_std_area_code>310100</dep_std_area_code>
            <is_refund>1</is_refund>
            <arr_std_city_name>南京</arr_std_city_name>
            <refund_mode>1</refund_mode>
            <dep_display_name>上海出发</dep_display_name>
            <extra_schedule>false</extra_schedule>
            <pre_sell_time>60</pre_sell_time>
            <arr_time>2023-09-01T12:00:00Z</arr_time>
            <spend_time>120</spend_time>
            <status>1</status>
            <bus_number_id>busNumberUUID</bus_number_id>
            <half_price>20</half_price>
            <distance>30</distance>
            <with_child_stock>3</with_child_stock>
            <support_ele_ticket>true</support_ele_ticket>
        </bus_item_infos>
    </bus_item_infos>
    <result_code>SYS_ERROR</result_code>
    <result_msg>系统异常</result_msg>
    <is_success>true</is_success>
</bus_number_get_response>

{
    "bus_number_get_response":{
        "bus_item_infos":{
            "bus_item_infos":[
                {
                    "dep_std_province_name":"上海市",
                    "arr_std_station_code":"NJ_STATION_CODE_001",
                    "biz_type":5,
                    "check_ticket_type":"电子票",
                    "route_key":"ROUTE_KEY_001",
                    "obtain_ticket_type":"自助取票机",
                    "station_start_time":"07:00",
                    "dep_date":"2023-09-01T00:00:00Z",
                    "dep_std_area_name":"上海市中心",
                    "pre_sell_day":7,
                    "arr_std_area_code":320100,
                    "price":200,
                    "refund_rule":"退票规则A",
                    "transfer_mode":0,
                    "dep_std_city_name":"上海",
                    "bus_type":"大型客车",
                    "stock":50,
                    "station_end_time":"23:00",
                    "arr_std_station_name":"南京火车站",
                    "arr_display_name":"南京到达",
                    "arr_std_province_name":"江苏省",
                    "dep_std_city_code":310000,
                    "parent_route_key":"PARENT_ROUTE_KEY_001",
                    "item_unique_key":"ITEM_UNIQUE_KEY_001",
                    "shift_type":0,
                    "arr_std_city_code":320000,
                    "dep_time":"2023-09-01T08:00:00Z",
                    "refund_time":30,
                    "dep_std_station_name":"上海火车站",
                    "support_child":true,
                    "last_dep_time":"2023-09-01T09:00:00Z",
                    "support_with_child":false,
                    "agent_route_id":10001,
                    "arr_std_area_name":"南京市中心",
                    "service_price":20,
                    "dep_std_station_code":"SH_STATION_CODE_001",
                    "dep_std_area_code":310100,
                    "is_refund":1,
                    "arr_std_city_name":"南京",
                    "refund_mode":1,
                    "dep_display_name":"上海出发",
                    "extra_schedule":false,
                    "pre_sell_time":60,
                    "arr_time":"2023-09-01T12:00:00Z",
                    "spend_time":"120",
                    "status":1,
                    "bus_number_id":"busNumberUUID",
                    "half_price":20,
                    "distance":30,
                    "with_child_stock":3,
                    "support_ele_ticket":true
                }
            ]
        },
        "result_code":"SYS_ERROR",
        "result_msg":"系统异常",
        "is_success":true
    }
}

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>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

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

开放平台

汽车票API

taobao.bus.number.get (查询汽车票班次)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ