飞猪 - 开放平台

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
param0	QueryOrderRQ	可选			rq
└ ttp_order_id Number 必须 12314 主单号

名称	类型	示例值	描述
result	TapResult		rs
└ success Boolean false success module QueryOrderRS 订单详情 tap_order TapOrderVO 主单详情 └ ttp_order_id Number 5353535353 主单号 └ last_issue_time Date 2021-12-11 12:01:02 最晚出票时间 └ ticket_num Number 1 票数 └ order_status_name String 待抢单主单状态 └ emergency Boolean true 是否为紧急单 └ vip_settle_mode Number 0 支付方式（0 现金 1 电子支付） └ tp_order_id Number 32424243 退改订单号 └ account_audit_order Boolean false 是否是账单审计订单-true、false和null，其中null代表未知，字段在监听审计通知消息时生效，一般在出票成功回填后1min内 ticket_infos TicketInfoDTO [] 票详情 └ passenger_name String 言煜乘车人姓名 └ passenger_type_code String 1 乘车人类型 └ mobile_no String 15623821921 手机号 └ certificate_type_code String 1 证件类型 └ certificate_no String 3333333333333333333 证件号 └ national String CN 国籍 tap_sub_orders TapSubOrderVO [] 子单详情 └ ttp_order_id Number 43253453 主订单号 └ sub_order_id Number 4535353 子订单号 └ from_station_name String 北京出发站 └ from_station_telecode String BJG 出发站三字码 └ to_station_name String 杭州到达站 └ to_station_telecode String HGZ 到达站三字码 └ train_date String 2021-12-11 发车日期 └ train_code String Z24 车次编号 └ seat_type_code String 1 座席编号 └ seat_type_name String 硬座座席名称 └ ticket_price Number 12100 票价（单位分） └ online_book_seat String 1F 在线选座参数(GDC支持在线选座，此坐席为优选坐席，出票员可以优先保证此字段解析的坐席) └ vip_custom_type Number 0 定制票类型（0:不指定坐席 1:下铺 2:下铺or中铺 3:过道 4:靠窗） └ inter_change_station_telecode String NJG 中转站三字码 └ inter_change_station_name String 南京中转站名称 └ segment_id Number 453535355 程id └ segment_index Number 1 程序号（区分中转一、二程） └ from_time String 12:54 出发时间 └ to_time String 21:32 到达时间 └ status_name String 锁单中子单状态 └ emergency Boolean false 是否为紧急单 └ last_issue_time String 2021-12-11 12:00:00 子单出票截止时间（yyyy-MM-dd HH:mm:ss） └ error_code Number -1 返回code └ error_msg String 系统错误返回msg

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TrainAgentOrderQueryRequest req = new TrainAgentOrderQueryRequest();
TrainAgentOrderQueryRequest.QueryOrderRQ obj1 = new TrainAgentOrderQueryRequest.QueryOrderRQ();
obj1.setTtpOrderId(12314L);
req.setParam0(obj1);
TrainAgentOrderQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TrainAgentOrderQueryRequest req = new TrainAgentOrderQueryRequest();
TrainAgentOrderQueryRequest.QueryOrderRQDomain obj1 = new TrainAgentOrderQueryRequest.QueryOrderRQDomain();
obj1.TtpOrderId = 12314L;
req.Param0_ = obj1;
TrainAgentOrderQueryResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TrainAgentOrderQueryRequest;
$param0 = new QueryOrderRQ;
$param0->ttp_order_id="12314";
$req->setParam0(json_encode($param0));
$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.order.query' \
-d 'partner_id=apidoc' \
-d 'session=1a6be91a-5e8f-48f0-9748-2c2ee34d2946' \
-d 'sign=A997AF6B1278F0D4C13BE530E39F7E01' \
-d 'sign_method=hmac' \
-d 'timestamp=2024-09-19+22%3A47%3A47' \
-d 'v=2.0' \
-d 'param0=null'

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

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

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

XML示例
JSON示例

<train_agent_order_query_response>
    <result>
        <success>false</success>
        <module>
            <tap_order>
                <ttp_order_id>5353535353</ttp_order_id>
                <last_issue_time>2021-12-11 12:01:02</last_issue_time>
                <ticket_num>1</ticket_num>
                <order_status_name>待抢单</order_status_name>
                <emergency>true</emergency>
                <vip_settle_mode>0</vip_settle_mode>
                <tp_order_id>32424243</tp_order_id>
                <account_audit_order>false</account_audit_order>
            </tap_order>
            <ticket_infos>
                <ticket_info_d_t_o>
                    <passenger_name>言煜</passenger_name>
                    <passenger_type_code>1</passenger_type_code>
                    <mobile_no>15623821921</mobile_no>
                    <certificate_type_code>1</certificate_type_code>
                    <certificate_no>3333333333333333333</certificate_no>
                    <national>CN</national>
                </ticket_info_d_t_o>
            </ticket_infos>
            <tap_sub_orders>
                <tap_sub_order_v_o>
                    <ttp_order_id>43253453</ttp_order_id>
                    <sub_order_id>4535353</sub_order_id>
                    <from_station_name>北京</from_station_name>
                    <from_station_telecode>BJG</from_station_telecode>
                    <to_station_name>杭州</to_station_name>
                    <to_station_telecode>HGZ</to_station_telecode>
                    <train_date>2021-12-11</train_date>
                    <train_code>Z24</train_code>
                    <seat_type_code>1</seat_type_code>
                    <seat_type_name>硬座</seat_type_name>
                    <ticket_price>12100</ticket_price>
                    <online_book_seat>1F</online_book_seat>
                    <vip_custom_type>0</vip_custom_type>
                    <inter_change_station_telecode>NJG</inter_change_station_telecode>
                    <inter_change_station_name>南京</inter_change_station_name>
                    <segment_id>453535355</segment_id>
                    <segment_index>1</segment_index>
                    <from_time>12:54</from_time>
                    <to_time>21:32</to_time>
                    <status_name>锁单中</status_name>
                    <emergency>false</emergency>
                    <last_issue_time>2021-12-11 12:00:00</last_issue_time>
                </tap_sub_order_v_o>
            </tap_sub_orders>
        </module>
        <error_code>-1</error_code>
        <error_msg>系统错误</error_msg>
    </result>
</train_agent_order_query_response>

{
    "train_agent_order_query_response":{
        "result":{
            "success":false,
            "module":{
                "tap_order":{
                    "ttp_order_id":5353535353,
                    "last_issue_time":"2021-12-11 12:01:02",
                    "ticket_num":1,
                    "order_status_name":"待抢单",
                    "emergency":true,
                    "vip_settle_mode":0,
                    "tp_order_id":32424243,
                    "account_audit_order":false
                },
                "ticket_infos":{
                    "ticket_info_d_t_o":[
                        {
                            "passenger_name":"言煜",
                            "passenger_type_code":"1",
                            "mobile_no":"15623821921",
                            "certificate_type_code":"1",
                            "certificate_no":"3333333333333333333",
                            "national":"CN"
                        }
                    ]
                },
                "tap_sub_orders":{
                    "tap_sub_order_v_o":[
                        {
                            "ttp_order_id":43253453,
                            "sub_order_id":4535353,
                            "from_station_name":"北京",
                            "from_station_telecode":"BJG",
                            "to_station_name":"杭州",
                            "to_station_telecode":"HGZ",
                            "train_date":"2021-12-11",
                            "train_code":"Z24",
                            "seat_type_code":"1",
                            "seat_type_name":"硬座",
                            "ticket_price":12100,
                            "online_book_seat":"1F",
                            "vip_custom_type":0,
                            "inter_change_station_telecode":"NJG",
                            "inter_change_station_name":"南京",
                            "segment_id":453535355,
                            "segment_index":1,
                            "from_time":"12:54",
                            "to_time":"21:32",
                            "status_name":"锁单中",
                            "emergency":false,
                            "last_issue_time":"2021-12-11 12:00:00"
                        }
                    ]
                }
            },
            "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.order.query (订单详情查询)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ