淘宝开放平台

请求地址：

环境	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。

名称	类型	是否必须	示例值	更多限制	描述
param_top_bus_number_update_r_q	TopBusNumberUpdateRq	必须			请求参数
numbers BusNumberDto [] 必须车次列表 └ agent_from_city_id String 必须 12345 始发城市ID └ agent_from_station_id String 必须 45678 始发车站ID └ arrive_time String 可选 2018-02-10 10:00 到达时间（格式：yyyy-MM-dd HH:mm） └ attribute String 可选 {"busshortname":"枋湖客运中心","departstationcode":"350200FHZX","hashid":"-1001410211266152181","iscansell":"1","seattype":"普通","stationid":"8030112600505084541","stationname":"顺昌","stationorgid":"901120000001738","vehicletype":"0"} 其他非格式化属性合并成一个json格式字符串，对接时明确约定 └ biz_type Number 必须 0 业务类型（0:普通汽车票；1:机场巴士；2:景区巴士，默认为0） └ book_limit_time Number 可选 15 发车前多少分钟停止售票(单位：分钟) └ bus_number String 必须 A123 客车车次 └ bus_type String 可选大型客车车型 └ depart_time String 必须 2018-02-10 09:00 出发时间（格式：yyyy-MM-dd HH:mm） └ destination_name String 必须大柳树目的地名称 └ distance Number 可选 90 里程(单位：km) └ extra_schedule Number 必须 0 是否加班车（1是，0否） └ from_city_name String 必须北京始发城市名 └ from_station_name String 必须八王坟客运站始发车站名 └ full_price Number 必须 100 全票价,单位分 └ half_price Number 可选 50 半票价，单位分 └ is_refund Number 必须 1 是否可退票（1是，0否） └ last_schedule String 可选 19:00 最晚发车时间（格式：HH:mm） └ remain_seats Number 必须 20 余票数 └ run_time Number 可选 60 运行时长(单位：分钟) └ schedule_id String 必须 123456789 车次ID，需保持唯一 └ service_price Number 可选 100 服务费，单位分 └ shift_type Number 必须 0 班次类型（0固定班，1流水班） └ status Number 必须 1 车次状态（1可售；0停售） └ ticket_wicket String 可选 W3 检票口 └ to_city_name String 可选济南目的地城市 └ to_province_name String 可选山东省目的地省份 └ to_station_name String 可选大柳树车站目的地所属车站 └ total_seats Number 可选 42 总座位数 └ via_station String 可选北京,天津途经站

名称	类型	示例值	描述
result_code	String	SYSTEM_ERROR	错误码
result_msg	String	系统错误	错误描述
succ_count	Number	100	成功数量
is_success	Boolean	true	是否成功

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
BusNumbersUpdateRequest req = new BusNumbersUpdateRequest();
BusNumbersUpdateRequest.TopBusNumberUpdateRq obj1 = new BusNumbersUpdateRequest.TopBusNumberUpdateRq();
List<BusNumbersUpdateRequest.BusNumberDto> list3 = new ArrayList<BusNumbersUpdateRequest.BusNumberDto>();
BusNumbersUpdateRequest.BusNumberDto obj4 = new BusNumbersUpdateRequest.BusNumberDto();
list3.add(obj4);
obj4.setAgentFromCityId("12345");
obj4.setAgentFromStationId("45678");
obj4.setArriveTime("2018-02-10 10:00");
obj4.setAttribute("{\"busshortname\":\"枋湖客运中心\",\"departstationcode\":\"350200FHZX\",\"hashid\":\"-1001410211266152181\",\"iscansell\":\"1\",\"seattype\":\"普通\",\"stationid\":\"8030112600505084541\",\"stationname\":\"顺昌\",\"stationorgid\":\"901120000001738\",\"vehicletype\":\"0\"}");
obj4.setBizType(0L);
obj4.setBookLimitTime(15L);
obj4.setBusNumber("A123");
obj4.setBusType("大型");
obj4.setDepartTime("2018-02-10 09:00");
obj4.setDestinationName("大柳树");
obj4.setDistance(90L);
obj4.setExtraSchedule(0L);
obj4.setFromCityName("北京");
obj4.setFromStationName("八王坟客运站");
obj4.setFullPrice(100L);
obj4.setHalfPrice(50L);
obj4.setIsRefund(1L);
obj4.setLastSchedule("19:00");
obj4.setRemainSeats(20L);
obj4.setRunTime(60L);
obj4.setScheduleId("123456789");
obj4.setServicePrice(100L);
obj4.setShiftType(0L);
obj4.setStatus(1L);
obj4.setTicketWicket("W3");
obj4.setToCityName("济南");
obj4.setToProvinceName("山东省");
obj4.setToStationName("大柳树车站");
obj4.setTotalSeats(42L);
obj4.setViaStation("北京,天津");
obj1.setNumbers(list3);
req.setParamTopBusNumberUpdateRQ(obj1);
BusNumbersUpdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
BusNumbersUpdateRequest req = new BusNumbersUpdateRequest();
BusNumbersUpdateRequest.TopBusNumberUpdateRqDomain obj1 = new BusNumbersUpdateRequest.TopBusNumberUpdateRqDomain();
List<BusNumbersUpdateRequest.BusNumberDtoDomain> list3 = new List<BusNumbersUpdateRequest.BusNumberDtoDomain>();
BusNumbersUpdateRequest.BusNumberDtoDomain obj4 = new BusNumbersUpdateRequest.BusNumberDtoDomain();
list3.Add(obj4);
obj4.AgentFromCityId = "12345";
obj4.AgentFromStationId = "45678";
obj4.ArriveTime = "2018-02-10 10:00";
obj4.Attribute = "{\"busshortname\":\"枋湖客运中心\",\"departstationcode\":\"350200FHZX\",\"hashid\":\"-1001410211266152181\",\"iscansell\":\"1\",\"seattype\":\"普通\",\"stationid\":\"8030112600505084541\",\"stationname\":\"顺昌\",\"stationorgid\":\"901120000001738\",\"vehicletype\":\"0\"}";
obj4.BizType = 0L;
obj4.BookLimitTime = 15L;
obj4.BusNumber = "A123";
obj4.BusType = "大型";
obj4.DepartTime = "2018-02-10 09:00";
obj4.DestinationName = "大柳树";
obj4.Distance = 90L;
obj4.ExtraSchedule = 0L;
obj4.FromCityName = "北京";
obj4.FromStationName = "八王坟客运站";
obj4.FullPrice = 100L;
obj4.HalfPrice = 50L;
obj4.IsRefund = 1L;
obj4.LastSchedule = "19:00";
obj4.RemainSeats = 20L;
obj4.RunTime = 60L;
obj4.ScheduleId = "123456789";
obj4.ServicePrice = 100L;
obj4.ShiftType = 0L;
obj4.Status = 1L;
obj4.TicketWicket = "W3";
obj4.ToCityName = "济南";
obj4.ToProvinceName = "山东省";
obj4.ToStationName = "大柳树车站";
obj4.TotalSeats = 42L;
obj4.ViaStation = "北京,天津";
obj1.Numbers= list3;
req.ParamTopBusNumberUpdateRQ_ = obj1;
BusNumbersUpdateResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new BusNumbersUpdateRequest;
$param_top_bus_number_update_r_q = new TopBusNumberUpdateRq;
$numbers = new BusNumberDto;
$numbers->agent_from_city_id="12345";
$numbers->agent_from_station_id="45678";
$numbers->arrive_time="2018-02-10 10:00";
$numbers->attribute="{\"busshortname\":\"枋湖客运中心\",\"departstationcode\":\"350200FHZX\",\"hashid\":\"-1001410211266152181\",\"iscansell\":\"1\",\"seattype\":\"普通\",\"stationid\":\"8030112600505084541\",\"stationname\":\"顺昌\",\"stationorgid\":\"901120000001738\",\"vehicletype\":\"0\"}";
$numbers->biz_type="0";
$numbers->book_limit_time="15";
$numbers->bus_number="A123";
$numbers->bus_type="大型";
$numbers->depart_time="2018-02-10 09:00";
$numbers->destination_name="大柳树";
$numbers->distance="90";
$numbers->extra_schedule="0";
$numbers->from_city_name="北京";
$numbers->from_station_name="八王坟客运站";
$numbers->full_price="100";
$numbers->half_price="50";
$numbers->is_refund="1";
$numbers->last_schedule="19:00";
$numbers->remain_seats="20";
$numbers->run_time="60";
$numbers->schedule_id="123456789";
$numbers->service_price="100";
$numbers->shift_type="0";
$numbers->status="1";
$numbers->ticket_wicket="W3";
$numbers->to_city_name="济南";
$numbers->to_province_name="山东省";
$numbers->to_station_name="大柳树车站";
$numbers->total_seats="42";
$numbers->via_station="北京,天津";
$param_top_bus_number_update_r_q->numbers = $numbers;
$req->setParamTopBusNumberUpdateRQ(json_encode($param_top_bus_number_update_r_q));
$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.numbers.update' \
-d 'partner_id=apidoc' \
-d 'session=8b5429b4-7fbc-4884-82cf-03c391fc6a4c' \
-d 'sign=E13DB63D21C2D9DDCFAD23225F0293CC' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-28+14%3A01%3A50' \
-d 'v=2.0' \
-d 'param_top_bus_number_update_r_q=null'

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

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

req.param_top_bus_number_update_r_q=""
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.numbers.update");
add_param(pRequest,"param_top_bus_number_update_r_q","数据结构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.numbers.update', {
	'param_top_bus_number_update_r_q':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<bus_numbers_update_response>
    <result_code>SYSTEM_ERROR</result_code>
    <result_msg>系统错误</result_msg>
    <succ_count>100</succ_count>
    <is_success>true</is_success>
</bus_numbers_update_response>

{
    "bus_numbers_update_response":{
        "result_code":"SYSTEM_ERROR",
        "result_msg":"系统错误",
        "succ_count":100,
        "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.numbers.update (汽车票车次更新服务)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ