淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
rq	OccupyOrderConfirmRQ	必须			请求参数
└ task_id Number 必须 1635187060363644928 任务id └ trade_id Number 必须 123 业务id └ account_username String 必须用户名 13277880456 occupy_result OccupyResultDTO 必须无占座结果 └ 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 OccupyTicketInfoDTO [] 必须 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 OccupyQueryPayResultDTO 可选支付结果 └ 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 OccupyMonitorInfoDTO 可选埋点信息 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

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

76

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TrainAgentOccupyorderConfirmSuccRequest req = new TrainAgentOccupyorderConfirmSuccRequest();
TrainAgentOccupyorderConfirmSuccRequest.OccupyOrderConfirmRQ obj1 = new TrainAgentOccupyorderConfirmSuccRequest.OccupyOrderConfirmRQ();
obj1.setTaskId(1635187060363644928L);
obj1.setTradeId(123L);
obj1.setAccountUsername("用户名");
TrainAgentOccupyorderConfirmSuccRequest.OccupyResultDTO obj2 = new TrainAgentOccupyorderConfirmSuccRequest.OccupyResultDTO();
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<TrainAgentOccupyorderConfirmSuccRequest.OccupyTicketInfoDTO> list4 = new ArrayList<TrainAgentOccupyorderConfirmSuccRequest.OccupyTicketInfoDTO>();
TrainAgentOccupyorderConfirmSuccRequest.OccupyTicketInfoDTO obj5 = new TrainAgentOccupyorderConfirmSuccRequest.OccupyTicketInfoDTO();
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);
TrainAgentOccupyorderConfirmSuccRequest.OccupyQueryPayResultDTO obj6 = new TrainAgentOccupyorderConfirmSuccRequest.OccupyQueryPayResultDTO();
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);
TrainAgentOccupyorderConfirmSuccRequest.OccupyMonitorInfoDTO obj7 = new TrainAgentOccupyorderConfirmSuccRequest.OccupyMonitorInfoDTO();
List<TrainAgentOccupyorderConfirmSuccRequest.MonitorItem> list9 = new ArrayList<TrainAgentOccupyorderConfirmSuccRequest.MonitorItem>();
TrainAgentOccupyorderConfirmSuccRequest.MonitorItem obj10 = new TrainAgentOccupyorderConfirmSuccRequest.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.setRq(obj1);
TrainAgentOccupyorderConfirmSuccResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

76

ITopClient client = new DefaultTopClient(url, appkey, secret);
TrainAgentOccupyorderConfirmSuccRequest req = new TrainAgentOccupyorderConfirmSuccRequest();
TrainAgentOccupyorderConfirmSuccRequest.OccupyOrderConfirmRQDomain obj1 = new TrainAgentOccupyorderConfirmSuccRequest.OccupyOrderConfirmRQDomain();
obj1.TaskId = 1635187060363644928L;
obj1.TradeId = 123L;
obj1.AccountUsername = "用户名";
TrainAgentOccupyorderConfirmSuccRequest.OccupyResultDTODomain obj2 = new TrainAgentOccupyorderConfirmSuccRequest.OccupyResultDTODomain();
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<TrainAgentOccupyorderConfirmSuccRequest.OccupyTicketInfoDTODomain> list4 = new List<TrainAgentOccupyorderConfirmSuccRequest.OccupyTicketInfoDTODomain>();
TrainAgentOccupyorderConfirmSuccRequest.OccupyTicketInfoDTODomain obj5 = new TrainAgentOccupyorderConfirmSuccRequest.OccupyTicketInfoDTODomain();
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;
TrainAgentOccupyorderConfirmSuccRequest.OccupyQueryPayResultDTODomain obj6 = new TrainAgentOccupyorderConfirmSuccRequest.OccupyQueryPayResultDTODomain();
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;
TrainAgentOccupyorderConfirmSuccRequest.OccupyMonitorInfoDTODomain obj7 = new TrainAgentOccupyorderConfirmSuccRequest.OccupyMonitorInfoDTODomain();
List<TrainAgentOccupyorderConfirmSuccRequest.MonitorItemDomain> list9 = new List<TrainAgentOccupyorderConfirmSuccRequest.MonitorItemDomain>();
TrainAgentOccupyorderConfirmSuccRequest.MonitorItemDomain obj10 = new TrainAgentOccupyorderConfirmSuccRequest.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.Rq_ = obj1;
TrainAgentOccupyorderConfirmSuccResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TrainAgentOccupyorderConfirmSuccRequest;
$rq = new OccupyOrderConfirmRQ;
$rq->task_id="1635187060363644928";
$rq->trade_id="123";
$rq->account_username="用户名";
$occupy_result = new OccupyResultDTO;
$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 OccupyTicketInfoDTO;
$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;
$rq->occupy_result = $occupy_result;
$query_pay_result = new OccupyQueryPayResultDTO;
$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";
$rq->query_pay_result = $query_pay_result;
$monitor_info = new OccupyMonitorInfoDTO;
$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;
$rq->monitor_info = $monitor_info;
$req->setRq(json_encode($rq));
$resp = $c->execute($req, $sessionKey);

XML示例
JSON示例

<train_agent_occupyorder_confirm_succ_response>
    <result>
        <success>false</success>
        <error_code>-1</error_code>
        <error_msg>系统繁忙</error_msg>
    </result>
</train_agent_occupyorder_confirm_succ_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测试工具错误码查询工具 SDK下载

火车票API

taobao.train.agent.occupyorder.confirm.succ (占座订单占座成功)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ