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

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
change_type	Number	可选	1		变更类型 1 增加，2 减少
business_id	String	可选	79312660023113	最大长度：50	业务流水号（标识唯一一次业务操作），幂等性验证
mz_user_id	String	可选	83121114		麦座会员用户id
asset_type	Number	可选	1		资产类型： 1=积分 2=余额 3=成长值
end_time	String	必须	2020-01-02 10:00:00		开始时间
start_time	String	必须	2020-01-02 10:00:00		结束时间，开始和结束时间最大间隔一个月
page_size	Number	必须	10		每页条数
page	Number	必须	1		当前页码
record_id	Number	可选	10086		麦座返回的明细记录ID

名称	类型	示例值	描述
result	ResultData		请求结果
└ msg String 成功提示信息 └ code String 200 状态码 data AssetDetailVO 资产变更记录 └ total_row Number 942 总行数 └ start_row Number 0 开始行 └ total_page Number 95 总页码 data_list DataList [] 返回对象 └ change_time String 2020-05-21 13:12:58 变更时间 └ change_reason String 使用账户和积分支付订单: 订单号[110230015203], 所需金额:[30.00], 所需积分:[1000], 会员编号:[3724001], 账户积分:[99939], 使用账户和积分支付后积分:[98939]. 原因 └ change_type Number 2 修改类型 └ business_id String demo 业务id └ change_value Number 1000 修改值 └ mz_user_id Number 3724001 麦座会员id └ asset_type Number 1 账户类型 └ record_id Number 10086 麦座返回的明细记录ID └ page_size Number 10 每页个数 └ page Number 1 页码 └ success Boolean true 成功

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaDamaiMzUserAssetRecordListRequest req = new AlibabaDamaiMzUserAssetRecordListRequest();
req.setChangeType(1L);
req.setBusinessId("79312660023113");
req.setMzUserId("83121114");
req.setAssetType(1L);
req.setEndTime("2020-01-02 10:00:00");
req.setStartTime("2020-01-02 10:00:00");
req.setPageSize(10L);
req.setPage(1L);
req.setRecordId(10086L);
AlibabaDamaiMzUserAssetRecordListResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaDamaiMzUserAssetRecordListRequest req = new AlibabaDamaiMzUserAssetRecordListRequest();
req.ChangeType = 1L;
req.BusinessId = "79312660023113";
req.MzUserId = "83121114";
req.AssetType = 1L;
req.EndTime = "2020-01-02 10:00:00";
req.StartTime = "2020-01-02 10:00:00";
req.PageSize = 10L;
req.Page = 1L;
req.RecordId = 10086L;
AlibabaDamaiMzUserAssetRecordListResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaDamaiMzUserAssetRecordListRequest;
$req->setChangeType("1");
$req->setBusinessId("79312660023113");
$req->setMzUserId("83121114");
$req->setAssetType("1");
$req->setEndTime("2020-01-02 10:00:00");
$req->setStartTime("2020-01-02 10:00:00");
$req->setPageSize("10");
$req->setPage("1");
$req->setRecordId("10086");
$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.mz.user.asset.record.list' \
-d 'partner_id=apidoc' \
-d 'sign=2C2BBF99A0C304ED4F0ECF80976A0546' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-06-21+00%3A46%3A42' \
-d 'v=2.0' \
-d 'asset_type=1' \
-d 'business_id=79312660023113' \
-d 'change_type=1' \
-d 'end_time=2020-01-02+10%3A00%3A00' \
-d 'mz_user_id=83121114' \
-d 'page=1' \
-d 'page_size=10' \
-d 'record_id=10086' \
-d 'start_time=2020-01-02+10%3A00%3A00'

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

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

req.change_type=1
req.business_id="79312660023113"
req.mz_user_id="83121114"
req.asset_type=1
req.end_time="2020-01-02 10:00:00"
req.start_time="2020-01-02 10:00:00"
req.page_size=10
req.page=1
req.record_id=10086
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.mz.user.asset.record.list");
add_param(pRequest,"change_type","1");
add_param(pRequest,"business_id","79312660023113");
add_param(pRequest,"mz_user_id","83121114");
add_param(pRequest,"asset_type","1");
add_param(pRequest,"end_time","2020-01-02 10:00:00");
add_param(pRequest,"start_time","2020-01-02 10:00:00");
add_param(pRequest,"page_size","10");
add_param(pRequest,"page","1");
add_param(pRequest,"record_id","10086");
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.damai.mz.user.asset.record.list', {
	'change_type':'1',
	'business_id':'79312660023113',
	'mz_user_id':'83121114',
	'asset_type':'1',
	'end_time':'2020-01-02 10:00:00',
	'start_time':'2020-01-02 10:00:00',
	'page_size':'10',
	'page':'1',
	'record_id':'10086'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_damai_mz_user_asset_record_list_response>
    <result>
        <msg>成功</msg>
        <code>200</code>
        <data>
            <total_row>942</total_row>
            <start_row>0</start_row>
            <total_page>95</total_page>
            <data_list>
                <data_list>
                    <change_time>2020-05-21 13:12:58</change_time>
                    <change_reason>使用账户和积分支付订单: 订单号[110230015203], 所需金额:[30.00], 所需积分:[1000], 会员编号:[3724001], 账户积分:[99939], 使用账户和积分支付后积分:[98939].</change_reason>
                    <change_type>2</change_type>
                    <business_id>demo</business_id>
                    <change_value>1000</change_value>
                    <mz_user_id>3724001</mz_user_id>
                    <asset_type>1</asset_type>
                    <record_id>10086</record_id>
                </data_list>
            </data_list>
            <page_size>10</page_size>
            <page>1</page>
        </data>
        <success>true</success>
    </result>
</alibaba_damai_mz_user_asset_record_list_response>

{
    "alibaba_damai_mz_user_asset_record_list_response":{
        "result":{
            "msg":"成功",
            "code":"200",
            "data":{
                "total_row":942,
                "start_row":0,
                "total_page":95,
                "data_list":{
                    "data_list":[
                        {
                            "change_time":"2020-05-21 13:12:58",
                            "change_reason":"使用账户和积分支付订单: 订单号[110230015203], 所需金额:[30.00], 所需积分:[1000], 会员编号:[3724001], 账户积分:[99939], 使用账户和积分支付后积分:[98939].",
                            "change_type":2,
                            "business_id":"demo",
                            "change_value":1000,
                            "mz_user_id":3724001,
                            "asset_type":1,
                            "record_id":10086
                        }
                    ]
                },
                "page_size":10,
                "page":1
            },
            "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"
	}
}

错误码	错误描述	解决方案
40100000	api未知错误	通用系统异常
40100001	api请求失败	通用业务异常
40100002	请求必须的参数不能为空	请求必须的参数不能为空
40100003	请求数据不存在	请求数据不存在
40100005	每页条数参数超出限制值	每页条数参数超出限制值
40100006	请求必须的参数麦座会员id不能为空	请求必须的参数麦座会员id不能为空
40101015	查询时间范围超出限制	查询时间范围超出限制

API测试工具错误码查询工具 SDK下载

麦座API

alibaba.damai.mz.user.asset.record.list (会员资产变更记录列表)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

用户导航

用户反馈

用户反馈

用户反馈