淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	描述
trace_id	String	可选	6d684a10-873a-5c84-878c-161f15923200	请求唯一ID
amap_order_id	String	必须	1541894302897424029	高德订单号
channel_order_id	String	可选	1541894302897	渠道订单号(接入公司自定义)
client_source	String	必须	amap-car	渠道来源,高德分配

名称	类型	示例值	描述
trace_id	String	6d684a10-873a-5c84-878c-161f15923200	请求唯一ID
result_code	String	0	状态码
result_msg	String	Success	状态码描述
amap_order_id	String	1541894302897424029	高德订单号
channel_order_id	String	1541894302897	渠道订单号(接入公司自定义)
order_info	OrderInfo		订单信息
└ amap_order_id String 1541894302897424029 高德订单号 └ channel_order_id String 1541894302897 渠道订单号(接入公司自定义) └ status Number 101 订单状态 └ city_id String 010 城市ID └ gd_service_id Number 1 订单类型 1 实时单 2 预约单 3接机单 4送机单 └ mobile String 15811657234 乘车人手机号 └ driver_name String 王师傅司机名称 └ driver_phone String 15877828358 司机手机号 └ car_type String 日产阳光车型 └ license_plate String 车牌号 └ driver_pic_url String 司机头像 └ start_lng String 116.488731 起始地点经度 └ start_lat String 40.002813 起始地点纬度 └ start_name String 金辉大厦起始地点名称 └ end_lng String 116.488731 目的地经度 └ end_lat String 40.002813 目的地纬度 └ end_name String 金辉大厦目的地名称 └ departure_time String 2020-09-24 12:22:22 行程时间 └ order_time String 2020-09-24 12:22:22 下单时间 └ accept_time String 2020-09-24 12:22:22 司机到达时间 └ arrive_time String 2020-09-24 12:22:22 司机到达时间 └ begin_charge_time String 2020-09-24 12:22:22 开始计价时间 └ finish_time String 2020-09-24 12:22:22 行程结束时间 └ normal_distance String 12324 实际行驶距离单位M └ normal_time String 213 实际行驶时间分钟 └ driver_car_code String car_shenzhou_api\|private-car\|4 实际车型代码 └ driver_car_color String 红色汽车的颜色 └ remark String 备注备注 └ privacy_number String 17138679162 隐私号 └ brand_icon_url String http://aososs.oss-cn-beijing.aliyuncs.com/private_car/1234/icon_upload/dd687333b4b4a0c727746def07821885/etravel_caocao_1593575409855.png 运力商图标URL └ brand_ride_type_name String 运力商车型名称曹操-舒适型 └ brand_ride_name String 运力商名称曹操出行 └ pay_type Number 支付类型 0在线支付 1线下支付 └ arr_air_code String SHA 接送机-到达机场三字码，接机必填 └ dep_air_code String XIY 接送机-出发机场三字码，送机必填 └ flight_date String 2020-09-24 12:22:22 接送机-航班出发日期，接机必填 13位毫秒 └ flight_no String MU5118 接送机-航班号，接机业务必填 └ transport_type String gd_express 运力类型 └ business_model Number 1 业务类型：0:出租车；1:网约车；2:巡转网（打表）；3:巡转网（线上） └ insurance_amount Number 50 保险金额,单位万元 └ pick_up_check_num String 1435 乘客上车核对号码 └ extend_info String {"cp_order_id":"23343254245345"} 扩展信息，格式是JSON字符串 └ allow_modify_dest Boolean true 是否允许修改目的地 └ passenger_privacy_number String 15877828358 代叫单，乘车人联系司机隐私号 └ vehicle_proof_info String {} 车辆凭证信息(JSON)，包含以下字段： 1.front_left_picture string 左前45度图片链接 2.back_right_picture string 右后45度图片 3.supply_pictures string[] 补充图片 └ driver_id String 0b7b18f417236008099302951e13e5 司机ID └ reassign_order Number 0 是否是改派订单 0: 非改派订单或暂未发生改派(101时) 1: 是改派订单 contact_vo ContactVo 发件信息收件信息（代驾取送车专用） └ start_contact_phone String 17883740932 发件人电话 └ start_contact_name String 张三发件人姓名 └ start_contact_privacy_number String 17883748765 发件人联系司机的隐私号 └ end_contact_name String 李四收件人姓名 └ end_contact_phone String 17883740932 收件人电话 └ end_contact_privacy_number String 17883748765 收件人联系司机的隐私号 └ pick_up_code String 123456 取车码 └ delivered_code String 123456 收车码 └ sub_gd_service_id String 12 子单类型
cost_info	CostInfo		费用信息
└ total_price String 123 总金额单位分 └ original_price String 123 原价格 (不改价与totalPrice一致) 单位分 cost_detail CostDetailInfo [] 费用详情费项 └ amount String 123 金额单位分 └ name String 起步价费项名称 └ type String "" 费项类型(可能没有)

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAmapChannelCarOrderDetailQueryRequest req = new AlibabaAmapChannelCarOrderDetailQueryRequest();
req.setTraceId("6d684a10-873a-5c84-878c-161f15923200");
req.setAmapOrderId("1541894302897424029");
req.setChannelOrderId("1541894302897");
req.setClientSource("amap-car");
AlibabaAmapChannelCarOrderDetailQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaAmapChannelCarOrderDetailQueryRequest req = new AlibabaAmapChannelCarOrderDetailQueryRequest();
req.TraceId = "6d684a10-873a-5c84-878c-161f15923200";
req.AmapOrderId = "1541894302897424029";
req.ChannelOrderId = "1541894302897";
req.ClientSource = "amap-car";
AlibabaAmapChannelCarOrderDetailQueryResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaAmapChannelCarOrderDetailQueryRequest;
$req->setTraceId("6d684a10-873a-5c84-878c-161f15923200");
$req->setAmapOrderId("1541894302897424029");
$req->setChannelOrderId("1541894302897");
$req->setClientSource("amap-car");
$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=alibaba.amap.channel.car.order.detail.query' \
-d 'partner_id=apidoc' \
-d 'sign=4A12978E09C7B164A241609D6D48FA17' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-11-07+00%3A12%3A19' \
-d 'v=2.0' \
-d 'amap_order_id=1541894302897424029' \
-d 'channel_order_id=1541894302897' \
-d 'client_source=amap-car' \
-d 'trace_id=6d684a10-873a-5c84-878c-161f15923200'

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

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

req.trace_id="6d684a10-873a-5c84-878c-161f15923200"
req.amap_order_id="1541894302897424029"
req.channel_order_id="1541894302897"
req.client_source="amap-car"
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,"alibaba.amap.channel.car.order.detail.query");
add_param(pRequest,"trace_id","6d684a10-873a-5c84-878c-161f15923200");
add_param(pRequest,"amap_order_id","1541894302897424029");
add_param(pRequest,"channel_order_id","1541894302897");
add_param(pRequest,"client_source","amap-car");
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('alibaba.amap.channel.car.order.detail.query', {
	'trace_id':'6d684a10-873a-5c84-878c-161f15923200',
	'amap_order_id':'1541894302897424029',
	'channel_order_id':'1541894302897',
	'client_source':'amap-car'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_amap_channel_car_order_detail_query_response>
    <trace_id>6d684a10-873a-5c84-878c-161f15923200</trace_id>
    <result_code>0</result_code>
    <result_msg>Success</result_msg>
    <amap_order_id>1541894302897424029</amap_order_id>
    <channel_order_id>1541894302897</channel_order_id>
    <order_info>
        <amap_order_id>1541894302897424029</amap_order_id>
        <channel_order_id>1541894302897</channel_order_id>
        <status>101</status>
        <city_id>010</city_id>
        <gd_service_id>1</gd_service_id>
        <mobile>15811657234</mobile>
        <driver_name>王师傅</driver_name>
        <driver_phone>15877828358</driver_phone>
        <car_type>日产阳光</car_type>
        <license_plate></license_plate>
        <driver_pic_url></driver_pic_url>
        <start_lng>116.488731</start_lng>
        <start_lat>40.002813</start_lat>
        <start_name>金辉大厦</start_name>
        <end_lng>116.488731</end_lng>
        <end_lat>40.002813</end_lat>
        <end_name>金辉大厦</end_name>
        <departure_time>2020-09-24 12:22:22</departure_time>
        <order_time>2020-09-24 12:22:22</order_time>
        <accept_time>2020-09-24 12:22:22</accept_time>
        <arrive_time>2020-09-24 12:22:22</arrive_time>
        <begin_charge_time>2020-09-24 12:22:22</begin_charge_time>
        <finish_time>2020-09-24 12:22:22</finish_time>
        <normal_distance>12324</normal_distance>
        <normal_time>213</normal_time>
        <driver_car_code>car_shenzhou_api|private-car|4</driver_car_code>
        <driver_car_color>红色</driver_car_color>
        <remark>备注</remark>
        <privacy_number>17138679162</privacy_number>
        <brand_icon_url>http://aososs.oss-cn-beijing.aliyuncs.com/private_car/1234/icon_upload/dd687333b4b4a0c727746def07821885/etravel_caocao_1593575409855.png</brand_icon_url>
        <brand_ride_type_name>运力商车型名称</brand_ride_type_name>
        <brand_ride_name>运力商名称</brand_ride_name>
        <pay_type>支付类型</pay_type>
        <arr_air_code>SHA</arr_air_code>
        <dep_air_code>XIY</dep_air_code>
        <flight_date>2020-09-24 12:22:22</flight_date>
        <flight_no>MU5118</flight_no>
        <transport_type>gd_express</transport_type>
        <business_model>1</business_model>
        <insurance_amount>50</insurance_amount>
        <pick_up_check_num>1435</pick_up_check_num>
        <extend_info>{&quot;cp_order_id&quot;:&quot;23343254245345&quot;}</extend_info>
        <allow_modify_dest>true</allow_modify_dest>
        <passenger_privacy_number>15877828358</passenger_privacy_number>
        <vehicle_proof_info>{}</vehicle_proof_info>
        <driver_id>0b7b18f417236008099302951e13e5</driver_id>
        <reassign_order>0</reassign_order>
        <contact_vo>
            <start_contact_phone>17883740932</start_contact_phone>
            <start_contact_name>张三</start_contact_name>
            <start_contact_privacy_number>17883748765</start_contact_privacy_number>
            <end_contact_name>李四</end_contact_name>
            <end_contact_phone>17883740932</end_contact_phone>
            <end_contact_privacy_number>17883748765</end_contact_privacy_number>
        </contact_vo>
        <pick_up_code>123456</pick_up_code>
        <delivered_code>123456</delivered_code>
        <sub_gd_service_id>12</sub_gd_service_id>
    </order_info>
    <cost_info>
        <total_price>123</total_price>
        <original_price>123</original_price>
        <cost_detail>
            <cost_detail_info>
                <amount>123</amount>
                <name>起步价</name>
                <type>&quot;&quot;</type>
            </cost_detail_info>
        </cost_detail>
    </cost_info>
</alibaba_amap_channel_car_order_detail_query_response>

{
    "alibaba_amap_channel_car_order_detail_query_response":{
        "trace_id":"6d684a10-873a-5c84-878c-161f15923200",
        "result_code":"0",
        "result_msg":"Success",
        "amap_order_id":"1541894302897424029",
        "channel_order_id":"1541894302897",
        "order_info":{
            "amap_order_id":"1541894302897424029",
            "channel_order_id":"1541894302897",
            "status":101,
            "city_id":"010",
            "gd_service_id":1,
            "mobile":"15811657234",
            "driver_name":"王师傅",
            "driver_phone":"15877828358",
            "car_type":"日产阳光",
            "license_plate":"",
            "driver_pic_url":"",
            "start_lng":"116.488731",
            "start_lat":"40.002813",
            "start_name":"金辉大厦",
            "end_lng":"116.488731",
            "end_lat":"40.002813",
            "end_name":"金辉大厦",
            "departure_time":"2020-09-24 12:22:22",
            "order_time":"2020-09-24 12:22:22",
            "accept_time":"2020-09-24 12:22:22",
            "arrive_time":"2020-09-24 12:22:22",
            "begin_charge_time":"2020-09-24 12:22:22",
            "finish_time":"2020-09-24 12:22:22",
            "normal_distance":"12324",
            "normal_time":"213",
            "driver_car_code":"car_shenzhou_api|private-car|4",
            "driver_car_color":"红色",
            "remark":"备注",
            "privacy_number":"17138679162",
            "brand_icon_url":"http:\/\/aososs.oss-cn-beijing.aliyuncs.com\/private_car\/1234\/icon_upload\/dd687333b4b4a0c727746def07821885\/etravel_caocao_1593575409855.png",
            "brand_ride_type_name":"运力商车型名称",
            "brand_ride_name":"运力商名称",
            "pay_type":支付类型,
            "arr_air_code":"SHA",
            "dep_air_code":"XIY",
            "flight_date":"2020-09-24 12:22:22",
            "flight_no":"MU5118",
            "transport_type":"gd_express",
            "business_model":1,
            "insurance_amount":50,
            "pick_up_check_num":"1435",
            "extend_info":"{\"cp_order_id\":\"23343254245345\"}",
            "allow_modify_dest":true,
            "passenger_privacy_number":"15877828358",
            "vehicle_proof_info":"{}",
            "driver_id":"0b7b18f417236008099302951e13e5",
            "reassign_order":0,
            "contact_vo":{
                "start_contact_phone":"17883740932",
                "start_contact_name":"张三",
                "start_contact_privacy_number":"17883748765",
                "end_contact_name":"李四",
                "end_contact_phone":"17883740932",
                "end_contact_privacy_number":"17883748765"
            },
            "pick_up_code":"123456",
            "delivered_code":"123456",
            "sub_gd_service_id":"12"
        },
        "cost_info":{
            "total_price":"123",
            "original_price":"123",
            "cost_detail":{
                "cost_detail_info":[
                    {
                        "amount":"123",
                        "name":"起步价",
                        "type":"\"\""
                    }
                ]
            }
        }
    }
}

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

alibaba.amap.channel.car.order.detail.query (订单详情)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ