淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
call_order_query_request	CallOrderQueryRequest	必须			外呼订单查询请求对象
└ allot_type Number 可选 1 分配类型 └ order_id String 可选 "T2026010100001" 订单ID └ call_result_type_list String [] 可选 [1,2] 外呼结果列表 └ executor_id String 可选 "W123456" 首次发起执行人工号 └ page_size Number 可选 20 每页条数(默认20,上限1000) └ event_type Number 可选 1 事件类型编码 └ sort Number 可选 0 排序方向:0=升序,1=降序 └ havana_id Number 可选 2222540551630 大麦havanaId └ perform_id Number 可选 268398472 场次ID └ allot_status Number 可选 1 外呼分配状态 └ executor_name String 可选 "张三" 首次发起执行人姓名 └ call_result_types String 可选 1,2 外呼结果(逗号分隔) └ execute_group_id Number 可选 100 执行组ID └ current_page Number 可选 1 当前页(从1开始) └ call_out_time_type Number 可选 1 播放时长类型

名称	类型	示例值	描述
result	Result		result
└ code String 234 code └ success Boolean true success model Model model └ cur_page_num Number 1 curPageNum └ total_num Number 4 totalNum └ page_size Number 20 pageSize model Model model └ announcement_info String 取消原因：接主办通知，场次取消，给您带来的不便敬请谅解。 announcementInfo └ perform_id Number 268398472 performId order_dto_list OrderDtoList [] orderDtoList └ need_recording_status Number 1 needRecordingStatus └ allot_type Number 123 allotType └ dm_user_id Number 27666155 dmUserId └ execute_group String 123 executeGroup └ order_id String 3299931662525008170 orderId └ call_result_type Number 123 callResultType └ havana_id Number 3737007081 havanaId └ call_out_time_name String 1 callOutTimeName └ need_allot_status Number 2 needAllotStatus └ allot_time String 1 allotTime └ allot_status Number 1 allotStatus └ call_result_type_name String 1 callResultTypeName └ allot_colour_status Number 2 allotColourStatus └ allot_status_name String 未分配 allotStatusName └ allot_type_name String 1 allotTypeName └ contacts_phone String 13812341234 外呼手机号 └ perform_name String 2026-06-01 星期一 15:30 performName └ project_name String 开心麻花沉浸式亲子儿童剧《小猪佩奇之奇妙一日游》 projectName └ recycle_status_name String 票纸是否回收：不回收 recycleStatusName └ message String success message

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaDamaiCalloutOrderListQueryRequest req = new AlibabaDamaiCalloutOrderListQueryRequest();
AlibabaDamaiCalloutOrderListQueryRequest.CallOrderQueryRequest obj1 = new AlibabaDamaiCalloutOrderListQueryRequest.CallOrderQueryRequest();
obj1.setAllotType(1L);
obj1.setOrderId("\"T2026010100001\"");
obj1.setCallResultTypeList("1,2");
obj1.setExecutorId("\"W123456\"");
obj1.setPageSize(20L);
obj1.setEventType(1L);
obj1.setSort(0L);
obj1.setHavanaId(2222540551630L);
obj1.setPerformId(268398472L);
obj1.setAllotStatus(1L);
obj1.setExecutorName("\"张三\"");
obj1.setCallResultTypes("1,2");
obj1.setExecuteGroupId(100L);
obj1.setCurrentPage(1L);
obj1.setCallOutTimeType(1L);
req.setCallOrderQueryRequest(obj1);
AlibabaDamaiCalloutOrderListQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaDamaiCalloutOrderListQueryRequest req = new AlibabaDamaiCalloutOrderListQueryRequest();
AlibabaDamaiCalloutOrderListQueryRequest.CallOrderQueryRequestDomain obj1 = new AlibabaDamaiCalloutOrderListQueryRequest.CallOrderQueryRequestDomain();
obj1.AllotType = 1L;
obj1.OrderId = "\"T2026010100001\"";
obj1.CallResultTypeList = "1,2";
obj1.ExecutorId = "\"W123456\"";
obj1.PageSize = 20L;
obj1.EventType = 1L;
obj1.Sort = 0L;
obj1.HavanaId = 2222540551630L;
obj1.PerformId = 268398472L;
obj1.AllotStatus = 1L;
obj1.ExecutorName = "\"张三\"";
obj1.CallResultTypes = "1,2";
obj1.ExecuteGroupId = 100L;
obj1.CurrentPage = 1L;
obj1.CallOutTimeType = 1L;
req.CallOrderQueryRequest_ = obj1;
AlibabaDamaiCalloutOrderListQueryResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaDamaiCalloutOrderListQueryRequest;
$call_order_query_request = new CallOrderQueryRequest;
$call_order_query_request->allot_type="1";
$call_order_query_request->order_id="\"T2026010100001\"";
$call_order_query_request->call_result_type_list="[1,2]";
$call_order_query_request->executor_id="\"W123456\"";
$call_order_query_request->page_size="20";
$call_order_query_request->event_type="1";
$call_order_query_request->sort="0";
$call_order_query_request->havana_id="2222540551630";
$call_order_query_request->perform_id="268398472";
$call_order_query_request->allot_status="1";
$call_order_query_request->executor_name="\"张三\"";
$call_order_query_request->call_result_types="1,2";
$call_order_query_request->execute_group_id="100";
$call_order_query_request->current_page="1";
$call_order_query_request->call_out_time_type="1";
$req->setCallOrderQueryRequest(json_encode($call_order_query_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.damai.callout.order.list.query' \
-d 'partner_id=apidoc' \
-d 'sign=158FE57AE50B785398C717941DD9BD0F' \
-d 'sign_method=hmac' \
-d 'timestamp=2026-08-24+02%3A43%3A00' \
-d 'v=2.0' \
-d 'call_order_query_request=null'

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

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

req.call_order_query_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.damai.callout.order.list.query");
add_param(pRequest,"call_order_query_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',
	'url': 'http://gw.api.taobao.com/router/rest'
});

client.execute('alibaba.damai.callout.order.list.query', {
	'call_order_query_request':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_damai_callout_order_list_query_response>
    <result>
        <code>234</code>
        <success>true</success>
        <model>
            <cur_page_num>1</cur_page_num>
            <total_num>4</total_num>
            <page_size>20</page_size>
            <model>
                <announcement_info>取消原因：接主办通知，场次取消，给您带来的不便敬请谅解。</announcement_info>
                <perform_id>268398472</perform_id>
                <order_dto_list>
                    <order_dto_list>
                        <need_recording_status>1</need_recording_status>
                        <allot_type>123</allot_type>
                        <dm_user_id>27666155</dm_user_id>
                        <execute_group>123</execute_group>
                        <order_id>3299931662525008170</order_id>
                        <call_result_type>123</call_result_type>
                        <havana_id>3737007081</havana_id>
                        <call_out_time_name>1</call_out_time_name>
                        <need_allot_status>2</need_allot_status>
                        <allot_time>1</allot_time>
                        <allot_status>1</allot_status>
                        <call_result_type_name>1</call_result_type_name>
                        <allot_colour_status>2</allot_colour_status>
                        <allot_status_name>未分配</allot_status_name>
                        <allot_type_name>1</allot_type_name>
                        <contacts_phone>13812341234</contacts_phone>
                    </order_dto_list>
                </order_dto_list>
                <perform_name>2026-06-01 星期一 15:30</perform_name>
                <project_name>开心麻花沉浸式亲子儿童剧《小猪佩奇之奇妙一日游》</project_name>
                <recycle_status_name>票纸是否回收：不回收</recycle_status_name>
            </model>
        </model>
        <message>success</message>
    </result>
</alibaba_damai_callout_order_list_query_response>

{
    "alibaba_damai_callout_order_list_query_response":{
        "result":{
            "code":"234",
            "success":true,
            "model":{
                "cur_page_num":1,
                "total_num":4,
                "page_size":20,
                "model":{
                    "announcement_info":"取消原因：接主办通知，场次取消，给您带来的不便敬请谅解。",
                    "perform_id":268398472,
                    "order_dto_list":{
                        "order_dto_list":[
                            {
                                "need_recording_status":1,
                                "allot_type":123,
                                "dm_user_id":27666155,
                                "execute_group":"123",
                                "order_id":"3299931662525008170",
                                "call_result_type":123,
                                "havana_id":3737007081,
                                "call_out_time_name":"1",
                                "need_allot_status":2,
                                "allot_time":"1",
                                "allot_status":1,
                                "call_result_type_name":"1",
                                "allot_colour_status":2,
                                "allot_status_name":"未分配",
                                "allot_type_name":"1",
                                "contacts_phone":"13812341234"
                            }
                        ]
                    },
                    "perform_name":"2026-06-01 星期一 15:30",
                    "project_name":"开心麻花沉浸式亲子儿童剧《小猪佩奇之奇妙一日游》",
                    "recycle_status_name":"票纸是否回收：不回收"
                }
            },
            "message":"success"
        }
    }
}

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.damai.callout.order.list.query (外呼订单列表查询)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ