阿里大于 -

请求地址：

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

名称	类型	是否必须	示例值	描述
extend_params	JSONObject	必须		扩展信息
└ order_date_type Number 必须 1 查询的订单日期类型，1-下单时间、2-支付时间、3-确认收货时间、4-退款时间 └ begin_time String 可选 2024-01-01 00:00:00 查询开始时间，必须yyyy-MM-dd HH:mm:ss └ end_time String 可选 2024-01-01 00:00:00 查询结束时间，必须yyyy-MM-dd HH:mm:ss └ mord_id String 可选 123 主订单id └ order_column String 必须 mord_id 排序字段 └ order_type Number 必须 1 排序类型，1-降序、2-升序
query_user_id	String	必须	123	主播ID
role_id	Number	必须	163	业务ID
page_size	Number	必须	10	页大小
page_num	Number	必须	1	页码

名称	类型	示例值	描述
msg_info	String	数据异常	msgInfo
msg_code	String	10000	msgCode
object	TopDataPageDTO		object
data OrderInfo [] 订单信息 └ mord_id String 123 主订单ID └ cate_level1_name String 女装/女士精品商品一级类目 └ refund_commission_amt String 123 预估佣金退款 └ daibo_name String 代播主播名称代播主播名称 └ refund_amt String 699 退款金额 └ content_title String 谁家的香云纱这么香？直播标题 └ case_end_time String 2024-08-23 08:48:09 退款时间 └ agency_commission_amt String 234 预估机构收入金额 └ outer_aduser_amt String 123 预估流量服务商分成金额 └ commission_amt String 123 预估佣金收入 └ item_title String LUOJIAWANG【沙伦玫瑰】夏季极简高级百搭红云纱龟裂纹时尚半裙商品标题 └ is_refund String Y 是否成功退款 └ live_start_time String 2024-08-22 20:08:34 开播时间 └ create_time String 2024-08-22 21:14:33 下单时间 └ content_id String 477801796042 场次id └ item_id String 816293631165 商品ID └ div_pay_amt String 699.0 支付金额 └ outer_aduser_ratio String 12 流量服务商分成比例 └ pay_time String 2024-08-22 21:15:56 支付时间 └ confirm_paid_amt String 123 确认收货金额 └ is_confirm String N 是否确认收货 └ daibo_id String 123 代播id └ confirm_paid_time String 2022-10-31 10:46:29 确认收货时间 └ commission_ratio String 12 佣金比例 └ order_id String 123 子订单ID └ total_count Number 1981 totalCount

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
LiveagencyOrdersOverviewGetRequest req = new LiveagencyOrdersOverviewGetRequest();
LiveagencyOrdersOverviewGetRequest.JSONObject obj1 = new LiveagencyOrdersOverviewGetRequest.JSONObject();
obj1.setOrderDateType(1L);
obj1.setBeginTime("2024-01-01 00:00:00");
obj1.setEndTime("2024-01-01 00:00:00");
obj1.setMordId("123");
obj1.setOrderColumn("mord_id");
obj1.setOrderType(1L);
req.setExtendParams(obj1);
req.setQueryUserId("123");
req.setRoleId(163L);
req.setPageSize(10L);
req.setPageNum(1L);
LiveagencyOrdersOverviewGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
LiveagencyOrdersOverviewGetRequest req = new LiveagencyOrdersOverviewGetRequest();
LiveagencyOrdersOverviewGetRequest.JSONObjectDomain obj1 = new LiveagencyOrdersOverviewGetRequest.JSONObjectDomain();
obj1.OrderDateType = 1L;
obj1.BeginTime = "2024-01-01 00:00:00";
obj1.EndTime = "2024-01-01 00:00:00";
obj1.MordId = "123";
obj1.OrderColumn = "mord_id";
obj1.OrderType = 1L;
req.ExtendParams_ = obj1;
req.QueryUserId = "123";
req.RoleId = 163L;
req.PageSize = 10L;
req.PageNum = 1L;
LiveagencyOrdersOverviewGetResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new LiveagencyOrdersOverviewGetRequest;
$extend_params = new JSONObject;
$extend_params->order_date_type="1";
$extend_params->begin_time="2024-01-01 00:00:00";
$extend_params->end_time="2024-01-01 00:00:00";
$extend_params->mord_id="123";
$extend_params->order_column="mord_id";
$extend_params->order_type="1";
$req->setExtendParams(json_encode($extend_params));
$req->setQueryUserId("123");
$req->setRoleId("163");
$req->setPageSize("10");
$req->setPageNum("1");
$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.liveagency.orders.overview.get' \
-d 'partner_id=apidoc' \
-d 'session=4e144087-a0c3-420a-b256-ffeb2d1ad7ed' \
-d 'sign=F007200BC580899177244C379D7C8742' \
-d 'sign_method=hmac' \
-d 'timestamp=2026-04-05+19%3A10%3A47' \
-d 'v=2.0' \
-d 'extend_params=null' \
-d 'page_num=1' \
-d 'page_size=10' \
-d 'query_user_id=123' \
-d 'role_id=163'

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

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

req.extend_params="数据结构示例JSON格式"
req.query_user_id="123"
req.role_id=163
req.page_size=10
req.page_num=1
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.liveagency.orders.overview.get");
add_param(pRequest,"extend_params","数据结构JSON示例");
add_param(pRequest,"query_user_id","123");
add_param(pRequest,"role_id","163");
add_param(pRequest,"page_size","10");
add_param(pRequest,"page_num","1");
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',
	'url': 'http://gw.api.taobao.com/router/rest'
});

client.execute('taobao.liveagency.orders.overview.get', {
	'extend_params':'数据结构JSON示例',
	'query_user_id':'123',
	'role_id':'163',
	'page_size':'10',
	'page_num':'1'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<liveagency_orders_overview_get_response>
    <msg_info>数据异常</msg_info>
    <msg_code>10000</msg_code>
    <object>
        <data>
            <order_info>
                <mord_id>123</mord_id>
                <cate_level1_name>女装/女士精品</cate_level1_name>
                <refund_commission_amt>123</refund_commission_amt>
                <daibo_name>代播主播名称</daibo_name>
                <refund_amt>699</refund_amt>
                <content_title>谁家的香云纱这么香？</content_title>
                <case_end_time>2024-08-23 08:48:09</case_end_time>
                <agency_commission_amt>234</agency_commission_amt>
                <outer_aduser_amt>123</outer_aduser_amt>
                <commission_amt>123</commission_amt>
                <item_title>LUOJIAWANG【沙伦玫瑰】夏季极简高级百搭红云纱龟裂纹时尚半裙</item_title>
                <is_refund>Y</is_refund>
                <live_start_time>2024-08-22 20:08:34</live_start_time>
                <create_time>2024-08-22 21:14:33</create_time>
                <content_id>477801796042</content_id>
                <item_id>816293631165</item_id>
                <div_pay_amt>699.0</div_pay_amt>
                <outer_aduser_ratio>12</outer_aduser_ratio>
                <pay_time>2024-08-22 21:15:56</pay_time>
                <confirm_paid_amt>123</confirm_paid_amt>
                <is_confirm>N</is_confirm>
                <daibo_id>123</daibo_id>
                <confirm_paid_time>2022-10-31 10:46:29</confirm_paid_time>
                <commission_ratio>12</commission_ratio>
                <order_id>123</order_id>
            </order_info>
        </data>
        <total_count>1981</total_count>
    </object>
</liveagency_orders_overview_get_response>

{
    "liveagency_orders_overview_get_response":{
        "msg_info":"数据异常",
        "msg_code":"10000",
        "object":{
            "data":{
                "order_info":[
                    {
                        "mord_id":"123",
                        "cate_level1_name":"女装\/女士精品",
                        "refund_commission_amt":"123",
                        "daibo_name":"代播主播名称",
                        "refund_amt":"699",
                        "content_title":"谁家的香云纱这么香？",
                        "case_end_time":"2024-08-23 08:48:09",
                        "agency_commission_amt":"234",
                        "outer_aduser_amt":"123",
                        "commission_amt":"123",
                        "item_title":"LUOJIAWANG【沙伦玫瑰】夏季极简高级百搭红云纱龟裂纹时尚半裙",
                        "is_refund":"Y",
                        "live_start_time":"2024-08-22 20:08:34",
                        "create_time":"2024-08-22 21:14:33",
                        "content_id":"477801796042",
                        "item_id":"816293631165",
                        "div_pay_amt":"699.0",
                        "outer_aduser_ratio":"12",
                        "pay_time":"2024-08-22 21:15:56",
                        "confirm_paid_amt":"123",
                        "is_confirm":"N",
                        "daibo_id":"123",
                        "confirm_paid_time":"2022-10-31 10:46:29",
                        "commission_ratio":"12",
                        "order_id":"123"
                    }
                ]
            },
            "total_count":1981
        }
    }
}

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.liveagency.orders.overview.get (机构主播/商家订单数据查询接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ