飞猪 - 开放平台

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
query_change_detail_rq	QueryChangeDetailRQ	必须			查询改签订单详情rq
└ agent_id Number 必须 333444555 代理商id └ change_apply_id Number 必须 520744121553 改签申请单id └ tp_order_id Number 可选 1779715812572607883 淘宝主单id └ ttp_order_id Number 可选 4812850813378 ttp单号

名称	类型	描述
change_apply_sub_orders	ChangeApplySubOrderDTO []	改签子单列表
└ passenger_name String 张三乘车人姓名 └ agent_id Number 333444555 代理商id └ change_apply_id Number 520744121553 改签申请单id └ original_seat_no String 003A 原票坐席号 └ original_seat_type_code String 14 原票坐席类型code └ original_seat_type_name String 二等座原票坐席类型名称 └ certificate_no String 11012312345678001 证件号 └ certificate_type_name String 二代身份证证件类型名称 └ certificate_type_code String 1 证件类型code └ sub_order_id Number 330744121553 子单单号 └ original_ticket_price String 400 原票票价(分) └ ticket_type_code Number 1 票类型code └ original_coach_name String 01 原票车厢名称 └ ticket_type_name String 成人票票类型名称 └ original_coach_no String 01 原票车厢号 └ change_seat_type_code String 14 改签票坐席类型code └ change_seat_type_name String 二等座改签票坐席类型名称 └ pre_ticket_price Number 400 用户提交改签票价(卧铺、儿童票都是按最高票价提交) └ change_cost Number 100 改签费
change_apply_order	ChangeApplyOrderDTO	改签申请单主单
└ tp_id Number 1779715812572607883 淘宝主单单号 └ original_to_station_code String ICW 原票到达站三字码 └ agent_id Number 333444555 代理商id └ change_ticket_type Number 0 改签票类型 0:改签 1:变更到站 └ change_apply_id Number 520744121553 改签申请单id └ change_from_station String 重庆西改签票出发站名称 └ original_sequence_no String EJ123456789 原票123N6订单号 └ settlement_mode Number 1 现金结算标示 0:现金结算 1:电子结算 └ change_from_station_code String CXW 改签票出发站三字码 └ change_to_station String 成都东改签票到达站名称 └ change_issue_timeout String 2023-01-05 12:00:00 改签出票超时时间 └ original_from_date_time String 2023-01-05 12:00:00 原票发车时间 └ change_to_date_time String 2023-01-05 12:00:00 改签票达到时间 └ original_train_code String G101 原票车次号 └ original_train_date String 20230105 原票发车日期 └ original_from_station String 重庆西原票出发站名称 └ change_to_station_code String ICW 改签票达到站三字码 └ original_to_station String 成都东原票达到站名称 └ original_from_station_code String CXW 原票出发站三字码 └ change_type Number 0 改签类型 0:低改高 1:平改 2:高改低 └ original_to_date_time String 2023-01-05 12:00:00 原票到达时间 └ ticket_price_all Number 1000 整单票价总金额 └ ttp_id Number 4812850813378 ttp单号 └ change_from_date_time String 2023-01-05 12:00:00 改签票发车时间 └ change_train_date String 2023-01-05 改签票发车日期 └ ticket_total_num Number 2 票数量 └ change_train_code String G102 改签票车次号 └ status Number 0 改签申请单状态 └ change_cost Number 100 改签费（分）
custom_made_list	CustomMadeItemDTO []	定制信息集合
└ custom_type String onlineBookSeat 定制类型 └ count Number 1 定制份数 └ carriage_custom String 05,06,07 定制车厢集合字符串 └ seat_custom String 1A1B1C 选座坐席号集合字符串 └ accept_no_vip_custom Number 1 是否接受非定制,0不接受,1接受

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TrainAgentChangeorderdetailQueryVtwoRequest req = new TrainAgentChangeorderdetailQueryVtwoRequest();
TrainAgentChangeorderdetailQueryVtwoRequest.QueryChangeDetailRQ obj1 = new TrainAgentChangeorderdetailQueryVtwoRequest.QueryChangeDetailRQ();
obj1.setAgentId(333444555L);
obj1.setChangeApplyId(520744121553L);
obj1.setTpOrderId(1779715812572607883L);
obj1.setTtpOrderId(4812850813378L);
req.setQueryChangeDetailRq(obj1);
TrainAgentChangeorderdetailQueryVtwoResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TrainAgentChangeorderdetailQueryVtwoRequest req = new TrainAgentChangeorderdetailQueryVtwoRequest();
TrainAgentChangeorderdetailQueryVtwoRequest.QueryChangeDetailRQDomain obj1 = new TrainAgentChangeorderdetailQueryVtwoRequest.QueryChangeDetailRQDomain();
obj1.AgentId = 333444555L;
obj1.ChangeApplyId = 520744121553L;
obj1.TpOrderId = 1779715812572607883L;
obj1.TtpOrderId = 4812850813378L;
req.QueryChangeDetailRq_ = obj1;
TrainAgentChangeorderdetailQueryVtwoResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TrainAgentChangeorderdetailQueryVtwoRequest;
$query_change_detail_rq = new QueryChangeDetailRQ;
$query_change_detail_rq->agent_id="333444555";
$query_change_detail_rq->change_apply_id="520744121553";
$query_change_detail_rq->tp_order_id="1779715812572607883";
$query_change_detail_rq->ttp_order_id="4812850813378";
$req->setQueryChangeDetailRq(json_encode($query_change_detail_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.changeorderdetail.query.vtwo' \
-d 'partner_id=apidoc' \
-d 'session=966d1a21-b234-47b3-a2ef-a986b6fea8be' \
-d 'sign=AB446BA552054C8ECF2BDCA120BCDBF7' \
-d 'sign_method=hmac' \
-d 'timestamp=2024-04-28+09%3A02%3A39' \
-d 'v=2.0' \
-d 'query_change_detail_rq=null'

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

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

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

XML示例
JSON示例

<train_agent_changeorderdetail_query_vtwo_response>
    <change_apply_sub_orders>
        <change_apply_sub_order_d_t_o>
            <passenger_name>张三</passenger_name>
            <agent_id>333444555</agent_id>
            <change_apply_id>520744121553</change_apply_id>
            <original_seat_no>003A</original_seat_no>
            <original_seat_type_code>14</original_seat_type_code>
            <original_seat_type_name>二等座</original_seat_type_name>
            <certificate_no>11012312345678001</certificate_no>
            <certificate_type_name>二代身份证</certificate_type_name>
            <certificate_type_code>1</certificate_type_code>
            <sub_order_id>330744121553</sub_order_id>
            <original_ticket_price>400</original_ticket_price>
            <ticket_type_code>1</ticket_type_code>
            <original_coach_name>01</original_coach_name>
            <ticket_type_name>成人票</ticket_type_name>
            <original_coach_no>01</original_coach_no>
            <change_seat_type_code>14</change_seat_type_code>
            <change_seat_type_name>二等座</change_seat_type_name>
            <pre_ticket_price>400</pre_ticket_price>
            <change_cost>100</change_cost>
        </change_apply_sub_order_d_t_o>
    </change_apply_sub_orders>
    <change_apply_order>
        <tp_id>1779715812572607883</tp_id>
        <original_to_station_code>ICW</original_to_station_code>
        <agent_id>333444555</agent_id>
        <change_ticket_type>0</change_ticket_type>
        <change_apply_id>520744121553</change_apply_id>
        <change_from_station>重庆西</change_from_station>
        <original_sequence_no>EJ123456789</original_sequence_no>
        <settlement_mode>1</settlement_mode>
        <change_from_station_code>CXW</change_from_station_code>
        <change_to_station>成都东</change_to_station>
        <change_issue_timeout>2023-01-05 12:00:00</change_issue_timeout>
        <original_from_date_time>2023-01-05 12:00:00</original_from_date_time>
        <change_to_date_time>2023-01-05 12:00:00</change_to_date_time>
        <original_train_code>G101</original_train_code>
        <original_train_date>20230105</original_train_date>
        <original_from_station>重庆西</original_from_station>
        <change_to_station_code>ICW</change_to_station_code>
        <original_to_station>成都东</original_to_station>
        <original_from_station_code>CXW</original_from_station_code>
        <change_type>0</change_type>
        <original_to_date_time>2023-01-05 12:00:00</original_to_date_time>
        <ticket_price_all>1000</ticket_price_all>
        <ttp_id>4812850813378</ttp_id>
        <change_from_date_time>2023-01-05 12:00:00</change_from_date_time>
        <change_train_date>2023-01-05</change_train_date>
        <ticket_total_num>2</ticket_total_num>
        <change_train_code>G102</change_train_code>
        <status>0</status>
        <change_cost>100</change_cost>
    </change_apply_order>
    <custom_made_list>
        <custom_made_item_d_t_o>
            <custom_type>onlineBookSeat</custom_type>
            <count>1</count>
            <carriage_custom>05,06,07</carriage_custom>
            <seat_custom>1A1B1C</seat_custom>
            <accept_no_vip_custom>1</accept_no_vip_custom>
        </custom_made_item_d_t_o>
    </custom_made_list>
</train_agent_changeorderdetail_query_vtwo_response>

{
    "train_agent_changeorderdetail_query_vtwo_response":{
        "change_apply_sub_orders":{
            "change_apply_sub_order_d_t_o":[
                {
                    "passenger_name":"张三",
                    "agent_id":333444555,
                    "change_apply_id":520744121553,
                    "original_seat_no":"003A",
                    "original_seat_type_code":"14",
                    "original_seat_type_name":"二等座",
                    "certificate_no":"11012312345678001",
                    "certificate_type_name":"二代身份证",
                    "certificate_type_code":"1",
                    "sub_order_id":330744121553,
                    "original_ticket_price":"400",
                    "ticket_type_code":1,
                    "original_coach_name":"01",
                    "ticket_type_name":"成人票",
                    "original_coach_no":"01",
                    "change_seat_type_code":"14",
                    "change_seat_type_name":"二等座",
                    "pre_ticket_price":400,
                    "change_cost":100
                }
            ]
        },
        "change_apply_order":{
            "tp_id":1779715812572607883,
            "original_to_station_code":"ICW",
            "agent_id":333444555,
            "change_ticket_type":0,
            "change_apply_id":520744121553,
            "change_from_station":"重庆西",
            "original_sequence_no":"EJ123456789",
            "settlement_mode":1,
            "change_from_station_code":"CXW",
            "change_to_station":"成都东",
            "change_issue_timeout":"2023-01-05 12:00:00",
            "original_from_date_time":"2023-01-05 12:00:00",
            "change_to_date_time":"2023-01-05 12:00:00",
            "original_train_code":"G101",
            "original_train_date":"20230105",
            "original_from_station":"重庆西",
            "change_to_station_code":"ICW",
            "original_to_station":"成都东",
            "original_from_station_code":"CXW",
            "change_type":0,
            "original_to_date_time":"2023-01-05 12:00:00",
            "ticket_price_all":1000,
            "ttp_id":4812850813378,
            "change_from_date_time":"2023-01-05 12:00:00",
            "change_train_date":"2023-01-05",
            "ticket_total_num":2,
            "change_train_code":"G102",
            "status":0,
            "change_cost":100
        },
        "custom_made_list":{
            "custom_made_item_d_t_o":[
                {
                    "custom_type":"onlineBookSeat",
                    "count":1,
                    "carriage_custom":"05,06,07",
                    "seat_custom":"1A1B1C",
                    "accept_no_vip_custom":1
                }
            ]
        }
    }
}

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.changeorderdetail.query.vtwo (火车票代理商接口-查询跑腿改签订单详情-含鉴权校验)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ