淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
reserve_order_occupy_rq	ReserveOrderOccupyRQ	必须			请求参数
└ task_id Number 必须 1635187060363644928 任务id └ grab_id Number 必须 123 抢票id └ account_username String 必须用户名 13277880456 occupy_result OccupyResult 必须无占座结果 └ pay_limit_time String 必须 20241209115039 支付超时时间 └ order_date String 必须 20241115 订单日期 └ sequence_no String 必须 EA84243106 票号 └ begin_time String 必须 1731654613506 开始时间 └ lose_time String 必须 1731654613506 结束时间 └ resign_flag String 必须 1 协议字段 └ ticket_totalnum String 必须 1 票数量 └ ticket_price_all String 必须 400 票价 ticket_infos TicketInfo [] 必须 list 占座列表 └ arrive_time String 必须 0800 协议字段 └ batch_no String 必须 1 批次号 └ coach_name String 必须 02 车厢名 └ coach_no String 必须 02 车厢号 └ from_station_name String 必须大连出发站 └ from_station_telecode String 必须 DLT 出发站code └ integral_pay_flag String 必须 N 协议字段 └ limit_time String 必须 20241209114039 协议字段 └ lose_time String 必须 20241209114039 协议字段 └ passenger_id_no String 必须 4114***********019 证件号 └ passenger_id_type_code String 必须 1 证件类型 └ passenger_name String 必须张三姓名 └ pay_mode_code String 必须 "" 协议字段 └ preference_rate String 必须 1 协议字段 └ preference_word String 必须 "" 协议字段 └ purpose_code String 必须 00 协议字段 └ seat_name String 必须 07F号座位名 └ seat_no String 必须 007F 座位号 └ seat_type_code String 必须 0 坐席类型 └ sequence_no String 必须 E249303965 票号 └ start_time String 必须 0618 开始时间 └ station_train_code String 必须 D7741 车次号 └ ticket_price String 必须 5.50 价格 └ ticket_type_code String 必须 1 票类型 └ to_station_name String 必须大连北到达站 └ to_station_telecode String 必须 DFT 到达站code └ trade_no String 必须 1232134 交易号 └ train_date String 必须 20241222 出发日期 └ passenger_born_date String 必须 19990101 生日 └ arrive_date String 必须 20241116 到达日期 query_pay_result QueryPayResult 必须支付结果 └ mer_sign_msg String 必须 1323123 协议字段 └ pay_order_id String 必须 123213 协议字段 └ amount String 必须 400 金额 └ trans_type String 必须 01 协议字段 └ tran_data String 必须 12312312 协议字段 └ app_id String 必须 0001 协议字段 └ interface_version String 必须 1.0 协议字段 └ interface_name String 必须 WAP_SERVLET 协议字段 └ epay_url String 必须 https://epay.12306.cn epayurl └ pay_url String 必须 https://epay.12306.cn 支付url monitor_info MonitorInfo 可选埋点信息 monitor_list MonitorItem [] 可选 null 埋点列表 └ step_name String 可选 com.cars.otsmobile.queryPassenger 步骤名称 └ step_start_time_millis Number 可选 1734681315716 步骤开始时间(ms) └ step_cost_time Number 可选 181 步骤耗时(ms) └ step_success Boolean 可选 true 步骤是否成功 └ step_result String 可选成功步骤失败原因

名称	类型	示例值	描述
result	TapResult		rs
└ success Boolean false 结果 └ error_code Number -1 失败code └ error_msg String 系统繁忙失败文案

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TrainAgentReserveorderoccupyConfirmRequest req = new TrainAgentReserveorderoccupyConfirmRequest();
TrainAgentReserveorderoccupyConfirmRequest.ReserveOrderOccupyRQ obj1 = new TrainAgentReserveorderoccupyConfirmRequest.ReserveOrderOccupyRQ();
obj1.setTaskId(1635187060363644928L);
obj1.setGrabId(123L);
obj1.setAccountUsername("用户名");
TrainAgentReserveorderoccupyConfirmRequest.OccupyResult obj2 = new TrainAgentReserveorderoccupyConfirmRequest.OccupyResult();
obj2.setPayLimitTime("20241209115039");
obj2.setOrderDate("20241115");
obj2.setSequenceNo("EA84243106");
obj2.setBeginTime("1731654613506");
obj2.setLoseTime("1731654613506");
obj2.setResignFlag("1");
obj2.setTicketTotalnum("1");
obj2.setTicketPriceAll("400");
List<TrainAgentReserveorderoccupyConfirmRequest.TicketInfo> list4 = new ArrayList<TrainAgentReserveorderoccupyConfirmRequest.TicketInfo>();
TrainAgentReserveorderoccupyConfirmRequest.TicketInfo obj5 = new TrainAgentReserveorderoccupyConfirmRequest.TicketInfo();
list4.add(obj5);
obj5.setArriveTime("0800");
obj5.setBatchNo("1");
obj5.setCoachName("02");
obj5.setCoachNo("02");
obj5.setFromStationName("大连");
obj5.setFromStationTelecode("DLT");
obj5.setIntegralPayFlag("N");
obj5.setLimitTime("20241209114039");
obj5.setLoseTime("20241209114039");
obj5.setPassengerIdNo("4114***********019");
obj5.setPassengerIdTypeCode("1");
obj5.setPassengerName("张三");
obj5.setPayModeCode("\"\"");
obj5.setPreferenceRate("1");
obj5.setPreferenceWord("\"\"");
obj5.setPurposeCode("00");
obj5.setSeatName("07F号");
obj5.setSeatNo("007F");
obj5.setSeatTypeCode("0");
obj5.setSequenceNo("E249303965");
obj5.setStartTime("0618");
obj5.setStationTrainCode("D7741");
obj5.setTicketPrice("5.50");
obj5.setTicketTypeCode("1");
obj5.setToStationName("大连北");
obj5.setToStationTelecode("DFT");
obj5.setTradeNo("1232134");
obj5.setTrainDate("20241222");
obj5.setPassengerBornDate("19990101");
obj5.setArriveDate("20241116");
obj2.setTicketInfos(list4);
obj1.setOccupyResult(obj2);
TrainAgentReserveorderoccupyConfirmRequest.QueryPayResult obj6 = new TrainAgentReserveorderoccupyConfirmRequest.QueryPayResult();
obj6.setMerSignMsg("1323123");
obj6.setPayOrderId("123213");
obj6.setAmount("400");
obj6.setTransType("01");
obj6.setTranData("12312312");
obj6.setAppId("0001");
obj6.setInterfaceVersion("1.0");
obj6.setInterfaceName("WAP_SERVLET");
obj6.setEpayUrl("https://epay.12306.cn");
obj6.setPayUrl("https://epay.12306.cn");
obj1.setQueryPayResult(obj6);
TrainAgentReserveorderoccupyConfirmRequest.MonitorInfo obj7 = new TrainAgentReserveorderoccupyConfirmRequest.MonitorInfo();
List<TrainAgentReserveorderoccupyConfirmRequest.MonitorItem> list9 = new ArrayList<TrainAgentReserveorderoccupyConfirmRequest.MonitorItem>();
TrainAgentReserveorderoccupyConfirmRequest.MonitorItem obj10 = new TrainAgentReserveorderoccupyConfirmRequest.MonitorItem();
list9.add(obj10);
obj10.setStepName("com.cars.otsmobile.queryPassenger");
obj10.setStepStartTimeMillis(1734681315716L);
obj10.setStepCostTime(181L);
obj10.setStepSuccess(true);
obj10.setStepResult("成功");
obj7.setMonitorList(list9);
obj1.setMonitorInfo(obj7);
req.setReserveOrderOccupyRq(obj1);
TrainAgentReserveorderoccupyConfirmResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TrainAgentReserveorderoccupyConfirmRequest req = new TrainAgentReserveorderoccupyConfirmRequest();
TrainAgentReserveorderoccupyConfirmRequest.ReserveOrderOccupyRQDomain obj1 = new TrainAgentReserveorderoccupyConfirmRequest.ReserveOrderOccupyRQDomain();
obj1.TaskId = 1635187060363644928L;
obj1.GrabId = 123L;
obj1.AccountUsername = "用户名";
TrainAgentReserveorderoccupyConfirmRequest.OccupyResultDomain obj2 = new TrainAgentReserveorderoccupyConfirmRequest.OccupyResultDomain();
obj2.PayLimitTime = "20241209115039";
obj2.OrderDate = "20241115";
obj2.SequenceNo = "EA84243106";
obj2.BeginTime = "1731654613506";
obj2.LoseTime = "1731654613506";
obj2.ResignFlag = "1";
obj2.TicketTotalnum = "1";
obj2.TicketPriceAll = "400";
List<TrainAgentReserveorderoccupyConfirmRequest.TicketInfoDomain> list4 = new List<TrainAgentReserveorderoccupyConfirmRequest.TicketInfoDomain>();
TrainAgentReserveorderoccupyConfirmRequest.TicketInfoDomain obj5 = new TrainAgentReserveorderoccupyConfirmRequest.TicketInfoDomain();
list4.Add(obj5);
obj5.ArriveTime = "0800";
obj5.BatchNo = "1";
obj5.CoachName = "02";
obj5.CoachNo = "02";
obj5.FromStationName = "大连";
obj5.FromStationTelecode = "DLT";
obj5.IntegralPayFlag = "N";
obj5.LimitTime = "20241209114039";
obj5.LoseTime = "20241209114039";
obj5.PassengerIdNo = "4114***********019";
obj5.PassengerIdTypeCode = "1";
obj5.PassengerName = "张三";
obj5.PayModeCode = "\"\"";
obj5.PreferenceRate = "1";
obj5.PreferenceWord = "\"\"";
obj5.PurposeCode = "00";
obj5.SeatName = "07F号";
obj5.SeatNo = "007F";
obj5.SeatTypeCode = "0";
obj5.SequenceNo = "E249303965";
obj5.StartTime = "0618";
obj5.StationTrainCode = "D7741";
obj5.TicketPrice = "5.50";
obj5.TicketTypeCode = "1";
obj5.ToStationName = "大连北";
obj5.ToStationTelecode = "DFT";
obj5.TradeNo = "1232134";
obj5.TrainDate = "20241222";
obj5.PassengerBornDate = "19990101";
obj5.ArriveDate = "20241116";
obj2.TicketInfos= list4;
obj1.OccupyResult= obj2;
TrainAgentReserveorderoccupyConfirmRequest.QueryPayResultDomain obj6 = new TrainAgentReserveorderoccupyConfirmRequest.QueryPayResultDomain();
obj6.MerSignMsg = "1323123";
obj6.PayOrderId = "123213";
obj6.Amount = "400";
obj6.TransType = "01";
obj6.TranData = "12312312";
obj6.AppId = "0001";
obj6.InterfaceVersion = "1.0";
obj6.InterfaceName = "WAP_SERVLET";
obj6.EpayUrl = "https://epay.12306.cn";
obj6.PayUrl = "https://epay.12306.cn";
obj1.QueryPayResult= obj6;
TrainAgentReserveorderoccupyConfirmRequest.MonitorInfoDomain obj7 = new TrainAgentReserveorderoccupyConfirmRequest.MonitorInfoDomain();
List<TrainAgentReserveorderoccupyConfirmRequest.MonitorItemDomain> list9 = new List<TrainAgentReserveorderoccupyConfirmRequest.MonitorItemDomain>();
TrainAgentReserveorderoccupyConfirmRequest.MonitorItemDomain obj10 = new TrainAgentReserveorderoccupyConfirmRequest.MonitorItemDomain();
list9.Add(obj10);
obj10.StepName = "com.cars.otsmobile.queryPassenger";
obj10.StepStartTimeMillis = 1734681315716L;
obj10.StepCostTime = 181L;
obj10.StepSuccess = true;
obj10.StepResult = "成功";
obj7.MonitorList= list9;
obj1.MonitorInfo= obj7;
req.ReserveOrderOccupyRq_ = obj1;
TrainAgentReserveorderoccupyConfirmResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TrainAgentReserveorderoccupyConfirmRequest;
$reserve_order_occupy_rq = new ReserveOrderOccupyRQ;
$reserve_order_occupy_rq->task_id="1635187060363644928";
$reserve_order_occupy_rq->grab_id="123";
$reserve_order_occupy_rq->account_username="用户名";
$occupy_result = new OccupyResult;
$occupy_result->pay_limit_time="20241209115039";
$occupy_result->order_date="20241115";
$occupy_result->sequence_no="EA84243106";
$occupy_result->begin_time="1731654613506";
$occupy_result->lose_time="1731654613506";
$occupy_result->resign_flag="1";
$occupy_result->ticket_totalnum="1";
$occupy_result->ticket_price_all="400";
$ticket_infos = new TicketInfo;
$ticket_infos->arrive_time="0800";
$ticket_infos->batch_no="1";
$ticket_infos->coach_name="02";
$ticket_infos->coach_no="02";
$ticket_infos->from_station_name="大连";
$ticket_infos->from_station_telecode="DLT";
$ticket_infos->integral_pay_flag="N";
$ticket_infos->limit_time="20241209114039";
$ticket_infos->lose_time="20241209114039";
$ticket_infos->passenger_id_no="4114***********019";
$ticket_infos->passenger_id_type_code="1";
$ticket_infos->passenger_name="张三";
$ticket_infos->pay_mode_code="\"\"";
$ticket_infos->preference_rate="1";
$ticket_infos->preference_word="\"\"";
$ticket_infos->purpose_code="00";
$ticket_infos->seat_name="07F号";
$ticket_infos->seat_no="007F";
$ticket_infos->seat_type_code="0";
$ticket_infos->sequence_no="E249303965";
$ticket_infos->start_time="0618";
$ticket_infos->station_train_code="D7741";
$ticket_infos->ticket_price="5.50";
$ticket_infos->ticket_type_code="1";
$ticket_infos->to_station_name="大连北";
$ticket_infos->to_station_telecode="DFT";
$ticket_infos->trade_no="1232134";
$ticket_infos->train_date="20241222";
$ticket_infos->passenger_born_date="19990101";
$ticket_infos->arrive_date="20241116";
$occupy_result->ticket_infos = $ticket_infos;
$reserve_order_occupy_rq->occupy_result = $occupy_result;
$query_pay_result = new QueryPayResult;
$query_pay_result->mer_sign_msg="1323123";
$query_pay_result->pay_order_id="123213";
$query_pay_result->amount="400";
$query_pay_result->trans_type="01";
$query_pay_result->tran_data="12312312";
$query_pay_result->app_id="0001";
$query_pay_result->interface_version="1.0";
$query_pay_result->interface_name="WAP_SERVLET";
$query_pay_result->epay_url="https://epay.12306.cn";
$query_pay_result->pay_url="https://epay.12306.cn";
$reserve_order_occupy_rq->query_pay_result = $query_pay_result;
$monitor_info = new MonitorInfo;
$monitor_list = new MonitorItem;
$monitor_list->step_name="com.cars.otsmobile.queryPassenger";
$monitor_list->step_start_time_millis="1734681315716";
$monitor_list->step_cost_time="181";
$monitor_list->step_success="true";
$monitor_list->step_result="成功";
$monitor_info->monitor_list = $monitor_list;
$reserve_order_occupy_rq->monitor_info = $monitor_info;
$req->setReserveOrderOccupyRq(json_encode($reserve_order_occupy_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.train.agent.reserveorderoccupy.confirm' \
-d 'partner_id=apidoc' \
-d 'session=29377ace-c842-4544-93c4-5d7c9a373a59' \
-d 'sign=567D1E6540DCB3E4A009C5D1B661C024' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-01-30+04%3A02%3A00' \
-d 'v=2.0' \
-d 'reserve_order_occupy_rq=null'

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

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

req.reserve_order_occupy_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.train.agent.reserveorderoccupy.confirm");
add_param(pRequest,"reserve_order_occupy_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.train.agent.reserveorderoccupy.confirm', {
	'reserve_order_occupy_rq':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<train_agent_reserveorderoccupy_confirm_response>
    <result>
        <success>false</success>
        <error_code>-1</error_code>
        <error_msg>系统繁忙</error_msg>
    </result>
</train_agent_reserveorderoccupy_confirm_response>

{
    "train_agent_reserveorderoccupy_confirm_response":{
        "result":{
            "success":false,
            "error_code":-1,
            "error_msg":"系统繁忙"
        }
    }
}

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.train.agent.reserveorderoccupy.confirm (预约单占座确认)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ