阿里安全开放平台-阿里聚安全

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
param_order_get_request	OrderGetRequest	必须			订单获取请求
└ create_begin_time String 可选 2023-09-10 09:12:00 订单创建时间-开始时间 └ create_end_time String 可选 2023-09-10 09:12:00 订单创建时间-结束时间 └ modified_begin_time String 可选 2023-09-10 09:12:00 订单修改时间-开始时间 └ modified_end_time String 可选 2023-09-10 09:12:00 订单修改时间-结束时间 └ order_id String 可选 020000000100000000000001xxxx4926 订单号 └ page_number Number 必须 1 分页页码，从0开始 └ page_size Number 必须 20 分页大小，默认每次20，最大不得超过100 └ user_work_no String 可选 000001 待查询用户工号 └ source_ta_head_id String 可选 100001 差旅单号 └ corp_id String 可选 -1 租户ID，一个应用使用多租户模式下启用，需要欢行提供

名称	类型	示例值	描述
result	ResultDTO		返回结果
content Page 业务处理返回结果 cotents TaxiOrderDTO [] 订单列表 expense_list OrderExpenseDetailDTO [] 订单费用信息；可空 └ amount String 100.000000000 金额；不可空 └ currency_code String CNY 币种；不可空 └ expense_detail String 打车费用费用类型描述；不可空 └ expense_type String TAXI_PRICE 费项类型：打车费用 TAXI_PRICE、退款 TAXI_REFUND_FEE；不可空 └ order_id String 020000000100000000000001xxxx4926 订单号；不可空 └ resource_id String 111 资源ID，资源唯一标识；不可空 └ expense_time String 2023-09-10 09:12:00 费用产生时间；不可空 └ apply_type String BOOK 预定类型：预定 BOOK，退款 REFUND；不可空 └ trade_action Number 1 支付方向：1支付 2退款；不可空 └ pay_type Number 1 支付类型：1企业支付，2个人支付；不可空 order_base_info OrderBaseDTO 订单基础信息 └ book_time String 2023-09-10 09:12:00 订单下单时间；不可空 └ buyer_user_name String 张三预订人名称；不可空 └ buyer_user_work_no String 000001 预订人工号；不可空 └ order_class_id String 6 订单主类型：4是机票、5是酒店、6是打车、7是火车；不可空 └ order_class_id_desc String 用车机酒火大类，是订单主类型的描述信息；不可空 └ order_class_second_id Number 23 订单子类型；不可空 └ order_class_second_id_desc String 国内用车国内国际等；不可空 └ order_id String 020000000100000000000001xxxx4926 欢行订单号；不可空 └ order_status String 700 订单状态：0-等待派单，2-等待接单，3-等待接单超时结束，5-等待司机接驾，4-已取消，400-取消产生费用待确认，6-取消产生费用已确认，404-取消产生费用费用异议，40-司机已到达，7-行驶中，50-行程结束待确认，500-行程结束费用异议，700-行程结束费用合理；不可空 └ order_status_desc String 行程结束费用合理订单状态描述，订单状态的描述；不可空 └ submit_user_name String 张三差旅单提交人名称；可空 └ submit_user_work_no String 000001 差旅单提交人工号；可空 └ supplier_order_id String 100001 供应商订单号；不可空 └ source_id String 100001 差旅单号；可空 └ source_ta_line_id String 1 来源系统差旅单行程ID，作为行程标识；可空 └ total_amount String 100.000000000 订单总金额；不可空 └ total_amount_currency_code String CNY 币种代码；不可空 └ company_code String A50 单据归属公司编码；不可空 └ company_pay_amount String 100.000000000 订单企业支付实付金额，等于订单费用中公付费用的金额总和；不可空 └ pay_mode Number 1 订单支付类型：1企业支付，2个人支付，3混合支付（企业支付+个人支付）；不可空 └ person_pay_amount String 100.000000000 订单个付实付金额，等于订单费用中个付费用的金额总和；可空 resource_list TaxiResourceDTO [] 打车详细信息，一个订单中仅存在一个打车资源信息 └ business_category String TRAFFIC 因公类型：TRAVEL- 差旅, TRAFFIC- 市内交通, NIGHT:-夜间；不可空 └ cancel_reason String 平台派单太远取消原因；可空 └ cancel_time String 2023-09-10 09:12:00 取消订单时间；可空 └ cancel_type Number 1 取消类型：0-系统取消，1-用户取消，2-司机取消，3-客服取消；可空 └ car_level String 600 供应商车型；不可空 └ complaint_type String 司机绕路投诉类型：0-其他原因，1-司机原因导致行程被取消，2-服务态度恶劣，3-未坐车产生费用，4-额外收取不合理费用，5-路不熟多产生费用，6-提前计费，7-未及时结束计费，8-司机绕路，9-司机迟到，10-司机爽约或拒载，11-骚扰乘客，12-危险驾驶，13-不是订单显示车辆或司机；可空 └ finish_time String 2023-09-10 09:12:00 行程结束时间；不可空 └ from_addr String 杭州市人民政府出发地名称；不可空 └ from_city_name String 杭州市出发地城市；不可空 └ is_cross_city String n 是否跨城，值为y表示是跨城，值为n表示未跨城；不可空 └ memo String 测试打车事由；可空 └ order_id String 020000000100000000000001xxxx4926 欢行订单号；不可空 └ passenger_name String 张三乘客姓名；不可空 └ pay_status String 0 支付状态：1-已支付，0-未支付；不可空 └ pay_time String 2023-09-10 09:12:00 支付时间；可空 └ provider_name String 曹操出行供应商名称；不可空 └ riding_time String 2023-09-10 09:12:00 预约乘车时间；可空 └ status_desc String 行程结束待确认状态描述；不可空 └ taken_time String 2023-09-10 09:12:00 乘客上车时间；不可空 └ time_type Number 0 时间类型：0-实时单，1-预约单；不可空 └ to_addr String 阿里巴巴西溪园区目的地名称；不可空 └ to_city_name String 杭州市目的地城市；不可空 └ travel_distance String 1.48 行驶距离；可空 └ travel_time Number 6 行驶时长（分钟）；可空 └ user_confirm Number 0 用户确认：0-未确认，1-认可，2-有异议；不可空 └ user_confirm_reason String 司机绕路用户认可/不认可原因；可空 └ user_confirm_time String 2023-09-10 09:12:00 用户确认时间；可空 └ user_work_no String 000001 工号；不可空 └ driver_license String 浙A88888 车牌号；可空 └ driver_car_type String 东风风神E70,白司机车型信息；可空 └ estimate_price String 100.000000000 订单预估价格；可空 └ resource_id String 111 资源ID，资源唯一标识；不可空 pagination Pagination 页码参数 └ page_number String 1 分页页码 └ page_size String 20 分页大小 └ total_count String 20 返回总数 └ error_code String 100000 错误码 └ error_msg String 内部服务处理异常错误信息 └ stack_trace String TaeBussinessException 错误异常栈 └ success String true 请求是否处理成功

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaHappytripOrderTaxiListRequest req = new AlibabaHappytripOrderTaxiListRequest();
AlibabaHappytripOrderTaxiListRequest.OrderGetRequest obj1 = new AlibabaHappytripOrderTaxiListRequest.OrderGetRequest();
obj1.setCreateBeginTime("2023-09-10 09:12:00");
obj1.setCreateEndTime("2023-09-10 09:12:00");
obj1.setModifiedBeginTime("2023-09-10 09:12:00");
obj1.setModifiedEndTime("2023-09-10 09:12:00");
obj1.setOrderId("020000000100000000000001xxxx4926");
obj1.setPageNumber(1L);
obj1.setPageSize(20L);
obj1.setUserWorkNo("000001");
obj1.setSourceTaHeadId("100001");
obj1.setCorpId("-1");
req.setParamOrderGetRequest(obj1);
AlibabaHappytripOrderTaxiListResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaHappytripOrderTaxiListRequest req = new AlibabaHappytripOrderTaxiListRequest();
AlibabaHappytripOrderTaxiListRequest.OrderGetRequestDomain obj1 = new AlibabaHappytripOrderTaxiListRequest.OrderGetRequestDomain();
obj1.CreateBeginTime = "2023-09-10 09:12:00";
obj1.CreateEndTime = "2023-09-10 09:12:00";
obj1.ModifiedBeginTime = "2023-09-10 09:12:00";
obj1.ModifiedEndTime = "2023-09-10 09:12:00";
obj1.OrderId = "020000000100000000000001xxxx4926";
obj1.PageNumber = 1L;
obj1.PageSize = 20L;
obj1.UserWorkNo = "000001";
obj1.SourceTaHeadId = "100001";
obj1.CorpId = "-1";
req.ParamOrderGetRequest_ = obj1;
AlibabaHappytripOrderTaxiListResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaHappytripOrderTaxiListRequest;
$param_order_get_request = new OrderGetRequest;
$param_order_get_request->create_begin_time="2023-09-10 09:12:00";
$param_order_get_request->create_end_time="2023-09-10 09:12:00";
$param_order_get_request->modified_begin_time="2023-09-10 09:12:00";
$param_order_get_request->modified_end_time="2023-09-10 09:12:00";
$param_order_get_request->order_id="020000000100000000000001xxxx4926";
$param_order_get_request->page_number="1";
$param_order_get_request->page_size="20";
$param_order_get_request->user_work_no="000001";
$param_order_get_request->source_ta_head_id="100001";
$param_order_get_request->corp_id="-1";
$req->setParamOrderGetRequest(json_encode($param_order_get_request));
$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.happytrip.order.taxi.list' \
-d 'partner_id=apidoc' \
-d 'sign=8DBB54762DD94879506F7355563CAA54' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-12-15+07%3A19%3A49' \
-d 'v=2.0' \
-d 'param_order_get_request=null'

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

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

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

XML示例
JSON示例

<alibaba_happytrip_order_taxi_list_response>
    <result>
        <content>
            <cotents>
                <taxi_order_d_t_o>
                    <expense_list>
                        <order_expense_detail_d_t_o>
                            <amount>100.000000000</amount>
                            <currency_code>CNY</currency_code>
                            <expense_detail>打车费用</expense_detail>
                            <expense_type>TAXI_PRICE</expense_type>
                            <order_id>020000000100000000000001xxxx4926</order_id>
                            <resource_id>111</resource_id>
                            <expense_time>2023-09-10 09:12:00</expense_time>
                            <apply_type>BOOK</apply_type>
                            <trade_action>1</trade_action>
                            <pay_type>1</pay_type>
                        </order_expense_detail_d_t_o>
                    </expense_list>
                    <order_base_info>
                        <book_time>2023-09-10 09:12:00</book_time>
                        <buyer_user_name>张三</buyer_user_name>
                        <buyer_user_work_no>000001</buyer_user_work_no>
                        <order_class_id>6</order_class_id>
                        <order_class_id_desc>用车</order_class_id_desc>
                        <order_class_second_id>23</order_class_second_id>
                        <order_class_second_id_desc>国内用车</order_class_second_id_desc>
                        <order_id>020000000100000000000001xxxx4926</order_id>
                        <order_status>700</order_status>
                        <order_status_desc>行程结束费用合理</order_status_desc>
                        <submit_user_name>张三</submit_user_name>
                        <submit_user_work_no>000001</submit_user_work_no>
                        <supplier_order_id>100001</supplier_order_id>
                        <source_id>100001</source_id>
                        <source_ta_line_id>1</source_ta_line_id>
                        <total_amount>100.000000000</total_amount>
                        <total_amount_currency_code>CNY</total_amount_currency_code>
                        <company_code>A50</company_code>
                        <company_pay_amount>100.000000000</company_pay_amount>
                        <pay_mode>1</pay_mode>
                        <person_pay_amount>100.000000000</person_pay_amount>
                    </order_base_info>
                    <resource_list>
                        <taxi_resource_d_t_o>
                            <business_category>TRAFFIC</business_category>
                            <cancel_reason>平台派单太远</cancel_reason>
                            <cancel_time>2023-09-10 09:12:00</cancel_time>
                            <cancel_type>1</cancel_type>
                            <car_level>600</car_level>
                            <complaint_type>司机绕路</complaint_type>
                            <finish_time>2023-09-10 09:12:00</finish_time>
                            <from_addr>杭州市人民政府</from_addr>
                            <from_city_name>杭州市</from_city_name>
                            <is_cross_city>n</is_cross_city>
                            <memo>测试</memo>
                            <order_id>020000000100000000000001xxxx4926</order_id>
                            <passenger_name>张三</passenger_name>
                            <pay_status>0</pay_status>
                            <pay_time>2023-09-10 09:12:00</pay_time>
                            <provider_name>曹操出行</provider_name>
                            <riding_time>2023-09-10 09:12:00</riding_time>
                            <status_desc>行程结束待确认</status_desc>
                            <taken_time>2023-09-10 09:12:00</taken_time>
                            <time_type>0</time_type>
                            <to_addr>阿里巴巴西溪园区</to_addr>
                            <to_city_name>杭州市</to_city_name>
                            <travel_distance>1.48</travel_distance>
                            <travel_time>6</travel_time>
                            <user_confirm>0</user_confirm>
                            <user_confirm_reason>司机绕路</user_confirm_reason>
                            <user_confirm_time>2023-09-10 09:12:00</user_confirm_time>
                            <user_work_no>000001</user_work_no>
                            <driver_license>浙A88888</driver_license>
                            <driver_car_type>东风风神E70,白</driver_car_type>
                            <estimate_price>100.000000000</estimate_price>
                            <resource_id>111</resource_id>
                        </taxi_resource_d_t_o>
                    </resource_list>
                </taxi_order_d_t_o>
            </cotents>
            <pagination>
                <page_number>1</page_number>
                <page_size>20</page_size>
            </pagination>
            <total_count>20</total_count>
        </content>
        <error_code>100000</error_code>
        <error_msg>内部服务处理异常</error_msg>
        <stack_trace>TaeBussinessException</stack_trace>
        <success>true</success>
    </result>
</alibaba_happytrip_order_taxi_list_response>

{
    "alibaba_happytrip_order_taxi_list_response":{
        "result":{
            "content":{
                "cotents":{
                    "taxi_order_d_t_o":[
                        {
                            "expense_list":{
                                "order_expense_detail_d_t_o":[
                                    {
                                        "amount":"100.000000000",
                                        "currency_code":"CNY",
                                        "expense_detail":"打车费用",
                                        "expense_type":"TAXI_PRICE",
                                        "order_id":"020000000100000000000001xxxx4926",
                                        "resource_id":"111",
                                        "expense_time":"2023-09-10 09:12:00",
                                        "apply_type":"BOOK",
                                        "trade_action":1,
                                        "pay_type":1
                                    }
                                ]
                            },
                            "order_base_info":{
                                "book_time":"2023-09-10 09:12:00",
                                "buyer_user_name":"张三",
                                "buyer_user_work_no":"000001",
                                "order_class_id":"6",
                                "order_class_id_desc":"用车",
                                "order_class_second_id":23,
                                "order_class_second_id_desc":"国内用车",
                                "order_id":"020000000100000000000001xxxx4926",
                                "order_status":"700",
                                "order_status_desc":"行程结束费用合理",
                                "submit_user_name":"张三",
                                "submit_user_work_no":"000001",
                                "supplier_order_id":"100001",
                                "source_id":"100001",
                                "source_ta_line_id":"1",
                                "total_amount":"100.000000000",
                                "total_amount_currency_code":"CNY",
                                "company_code":"A50",
                                "company_pay_amount":"100.000000000",
                                "pay_mode":1,
                                "person_pay_amount":"100.000000000"
                            },
                            "resource_list":{
                                "taxi_resource_d_t_o":[
                                    {
                                        "business_category":"TRAFFIC",
                                        "cancel_reason":"平台派单太远",
                                        "cancel_time":"2023-09-10 09:12:00",
                                        "cancel_type":1,
                                        "car_level":"600",
                                        "complaint_type":"司机绕路",
                                        "finish_time":"2023-09-10 09:12:00",
                                        "from_addr":"杭州市人民政府",
                                        "from_city_name":"杭州市",
                                        "is_cross_city":"n",
                                        "memo":"测试",
                                        "order_id":"020000000100000000000001xxxx4926",
                                        "passenger_name":"张三",
                                        "pay_status":"0",
                                        "pay_time":"2023-09-10 09:12:00",
                                        "provider_name":"曹操出行",
                                        "riding_time":"2023-09-10 09:12:00",
                                        "status_desc":"行程结束待确认",
                                        "taken_time":"2023-09-10 09:12:00",
                                        "time_type":0,
                                        "to_addr":"阿里巴巴西溪园区",
                                        "to_city_name":"杭州市",
                                        "travel_distance":"1.48",
                                        "travel_time":6,
                                        "user_confirm":0,
                                        "user_confirm_reason":"司机绕路",
                                        "user_confirm_time":"2023-09-10 09:12:00",
                                        "user_work_no":"000001",
                                        "driver_license":"浙A88888",
                                        "driver_car_type":"东风风神E70,白",
                                        "estimate_price":"100.000000000",
                                        "resource_id":"111"
                                    }
                                ]
                            }
                        }
                    ]
                },
                "pagination":{
                    "page_number":"1",
                    "page_size":"20"
                },
                "total_count":"20"
            },
            "error_code":"100000",
            "error_msg":"内部服务处理异常",
            "stack_trace":"TaeBussinessException",
            "success":"true"
        }
    }
}

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.happytrip.order.taxi.list (打车订单同步)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

用户导航

用户反馈

用户反馈

用户反馈