淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	描述
channelId	String	可选	20001	服务商渠道id
traceId	String	可选	111	本次请求的标识
orderId	Number	可选	122222	必填，飞猪平台订单id
outOrderId	String	可选	abcd	可选，外部商家订单号

名称	类型	示例值	描述
success	Boolean	true	接口调用是否成功
orderId	Number	122222	飞猪订单id
outOrderId	String	abcd	外部商家订单号
orderStatus	Number	11	外部商家订单状态。11-已接单等待派司机，12-已接单且已派司机，13-改派司机中，21-司机已出发，22-司机已开始服务，23-司机服务已完成，24-订单已完成，31-订单已取消
errorInfo	ErrorInfo		子错误信息
└ code String 1 错误码 └ message String 系统错误错误信息 └ subCode String 1 子错误码 └ subMessage String 系统错误子错误信息
transferOrderInfo	TransferOrderInfo	90020	订单基础信息
└ createdTime String 2022-11-11 20:00:00 订单创建时间 yyyy-MM-dd hhh:mm:ss └ modifiedTime String 2022-11-11 20:00:00 订单修改时间 yyyy-MM-dd hhh:mm:ss └ fromAddressDetail String 凤凰国际机场T2 起点详细地址 └ toAddressDetail String 三亚亚龙湾万豪度假酒店终点详细地址 └ distance Number 5002 出发地至目的地之间距离单位(米) └ refundTime String 2022-11-11 20:00:00 退款时间 yyyy-MM-dd hhh:mm:ss └ cancelReason String 不需要了关单/取消原因 └ useCarTime String 2022-11-11 20:00:00 用车时间(当地时间) yyyy-MM-dd hhh:mm:ss
transferDriverInfo	TransferDriverInfo		司机信息
└ driverPhone String 13499999999 司机联系方式 └ driverName String 马师傅名字 └ driverCaptain Number 1 队长 1:是 2:否 └ driverSecretPhone String 13499999999 司机联系方式-虚拟号
transferCarTypeInfo	TransferCarTypeInfo		车辆信息
└ autoBrand String 奥迪品牌 └ name String A6 车系 └ color String 红颜色 └ license String 京A12345 车牌号 └ passengerNum Number 4 核载人数 └ luggageNum Number 1 行李数
transferPassengerInfo	TransferPassengerInfo		乘客信息
└ passengerName String 马先生乘客姓名 └ passengerPhone String 13499999999 联系方式(乘车人号码，有可能为虚拟号) └ passengerRealPhoneLast String 9999 真实号码后四位
transferInvoiceInfo	TransferInvoiceInfo		发票信息
└ status Number 1 -1:未开具;1:开具中; 2:开具完成未发送; 3:开具完成已发送 └ invoiceType Number 1 发票类型 1:企业, 2:个人 └ amount String 20.01 开票金额(单位元) └ invoiceTitle String 浙江飞猪网络技术有限公司发票抬头 └ invoiceSendEmail String xxxx@163.com 发票寄送邮箱（用于电子发票） └ taxNo String 913301100947739005 企业（公司）税号 └ invoiceDownloadUrl String http://ssssssssss.com 发票下载地址 └ completeTime String 2022-11-11 20:00:00 开具完成时间 yyyy-MM-dd hhh:mm:ss
driverRouteInfo	DriverRouteInfo		司机行驶路径信息
waypoints WaypointPoiInfo [] 司机行使完整路径的所有点，用于C端用户行使路径显示 └ latitude String 39.907234 纬度 └ longitude String 116.357483 经度 └ distance String 60000 距离单位:米 └ expectedTime String 3000 预计用时单位:秒 additionalFees AdditionalFeeInfo [] 附加费用（高速费用）单位：元，备注这个如果有高速费用一定要传，并要传准，高速费减佣 └ additionalFee String 23 费用金额单位元 └ additionalFeeType Number 1 费用项:1:高速费用;2:停车费

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

QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
AlitripTransferOrderQueryRequest req = new AlitripTransferOrderQueryRequest();
req.setChannelId("20001");
req.setTraceId("111");
req.setOrderId(122222L);
req.setOutOrderId("abcd");
AlitripTransferOrderQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlitripTransferOrderQueryRequest req = new AlitripTransferOrderQueryRequest();
req.ChannelId = "20001";
req.TraceId = "111";
req.OrderId = 122222L;
req.OutOrderId = "abcd";
AlitripTransferOrderQueryResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlitripTransferOrderQueryRequest;
$req->setChannelId("20001");
$req->setTraceId("111");
$req->setOrderId("122222");
$req->setOutOrderId("abcd");
$resp = $c->execute($req);

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=qimen.alitrip.transfer.order.query' \
-d 'partner_id=apidoc' \
-d 'sign=F65CF2879FAFDF4D091ED16C460BD13C' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-29+17%3A21%3A35' \
-d 'v=2.0' \
-d 'channelId=20001' \
-d 'orderId=122222' \
-d 'outOrderId=abcd' \
-d 'traceId=111'

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

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

req.channelId="20001"
req.traceId="111"
req.orderId=122222
req.outOrderId="abcd"
try:
	resp= req.getResponse()
	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,"qimen.alitrip.transfer.order.query");
add_param(pRequest,"channelId","20001");
add_param(pRequest,"traceId","111");
add_param(pRequest,"orderId","122222");
add_param(pRequest,"outOrderId","abcd");
pResponse = top_execute(pClient,pRequest,NULL);
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('qimen.alitrip.transfer.order.query', {
	'channelId':'20001',
	'traceId':'111',
	'orderId':'122222',
	'outOrderId':'abcd'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<success>true</success>
<orderId>122222</orderId>
<outOrderId>abcd</outOrderId>
<orderStatus>11</orderStatus>
<errorInfo>
    <code>1</code>
    <message>系统错误</message>
    <subCode>1</subCode>
    <subMessage>系统错误</subMessage>
</errorInfo>
<transferOrderInfo>
    <createdTime>2022-11-11 20:00:00</createdTime>
    <modifiedTime>2022-11-11 20:00:00</modifiedTime>
    <fromAddressDetail>凤凰国际机场T2</fromAddressDetail>
    <toAddressDetail>三亚亚龙湾万豪度假酒店</toAddressDetail>
    <distance>5002</distance>
    <refundTime>2022-11-11 20:00:00</refundTime>
    <cancelReason>不需要了</cancelReason>
    <useCarTime>2022-11-11 20:00:00</useCarTime>
</transferOrderInfo>
<transferDriverInfo>
    <driverPhone>13499999999</driverPhone>
    <driverName>马师傅</driverName>
    <driverCaptain>1</driverCaptain>
    <driverSecretPhone>13499999999</driverSecretPhone>
</transferDriverInfo>
<transferCarTypeInfo>
    <autoBrand>奥迪</autoBrand>
    <name>A6</name>
    <color>红</color>
    <license>京A12345</license>
    <passengerNum>4</passengerNum>
    <luggageNum>1</luggageNum>
</transferCarTypeInfo>
<transferPassengerInfo>
    <passengerName>马先生</passengerName>
    <passengerPhone>13499999999</passengerPhone>
    <passengerRealPhoneLast>9999</passengerRealPhoneLast>
</transferPassengerInfo>
<transferInvoiceInfo>
    <status>1</status>
    <invoiceType>1</invoiceType>
    <amount>20.01</amount>
    <invoiceTitle>浙江飞猪网络技术有限公司</invoiceTitle>
    <invoiceSendEmail>xxxx@163.com</invoiceSendEmail>
    <taxNo>913301100947739005</taxNo>
    <invoiceDownloadUrl>http://ssssssssss.com</invoiceDownloadUrl>
    <completeTime>2022-11-11 20:00:00</completeTime>
</transferInvoiceInfo>
<driverRouteInfo>
    <waypoints>
        <waypoint_poi_info>
            <latitude>39.907234</latitude>
            <longitude>116.357483</longitude>
        </waypoint_poi_info>
    </waypoints>
    <distance>60000</distance>
    <expectedTime>3000</expectedTime>
    <additionalFees>
        <additional_fee_info>
            <additionalFee>23</additionalFee>
            <additionalFeeType>1</additionalFeeType>
        </additional_fee_info>
    </additionalFees>
</driverRouteInfo>

{
    "success":true,
    "orderId":122222,
    "outOrderId":"abcd",
    "orderStatus":11,
    "errorInfo":{
        "code":"1",
        "message":"系统错误",
        "subCode":"1",
        "subMessage":"系统错误"
    },
    "transferOrderInfo":{
        "createdTime":"2022-11-11 20:00:00",
        "modifiedTime":"2022-11-11 20:00:00",
        "fromAddressDetail":"凤凰国际机场T2",
        "toAddressDetail":"三亚亚龙湾万豪度假酒店",
        "distance":5002,
        "refundTime":"2022-11-11 20:00:00",
        "cancelReason":"不需要了",
        "useCarTime":"2022-11-11 20:00:00"
    },
    "transferDriverInfo":{
        "driverPhone":"13499999999",
        "driverName":"马师傅",
        "driverCaptain":1,
        "driverSecretPhone":"13499999999"
    },
    "transferCarTypeInfo":{
        "autoBrand":"奥迪",
        "name":"A6",
        "color":"红",
        "license":"京A12345",
        "passengerNum":4,
        "luggageNum":1
    },
    "transferPassengerInfo":{
        "passengerName":"马先生",
        "passengerPhone":"13499999999",
        "passengerRealPhoneLast":"9999"
    },
    "transferInvoiceInfo":{
        "status":1,
        "invoiceType":1,
        "amount":"20.01",
        "invoiceTitle":"浙江飞猪网络技术有限公司",
        "invoiceSendEmail":"xxxx@163.com",
        "taxNo":"913301100947739005",
        "invoiceDownloadUrl":"http:\/\/ssssssssss.com",
        "completeTime":"2022-11-11 20:00:00"
    },
    "driverRouteInfo":{
        "waypoints":{
            "waypoint_poi_info":[
                {
                    "latitude":"39.907234",
                    "longitude":"116.357483"
                }
            ]
        },
        "distance":"60000",
        "expectedTime":"3000",
        "additionalFees":{
            "additional_fee_info":[
                {
                    "additionalFee":"23",
                    "additionalFeeType":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

qimen.alitrip.transfer.order.query (接送机订单详情查询接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ