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

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
param0	BatchListEmployeeOrganizationsRequest	必须			请求参数
└ need_base_properties Boolean 必须 false 是否需要基础信息 └ need_supervisor Boolean 必须 false 是否需要主管 └ employee_codes String [] 可选 emp1 员工CODE列表 └ account_ids Number [] 可选 23 账号id列表 └ tenant_id Number 必须 10000035003 租户ID

名称	类型	示例值	描述
result	BatchListEmployeeOrganizationsResult		结果出参
datas EmployeeOrganizations [] 人员及所在组织信息 └ employee_code String testEmpCode 人员code └ employee_name String testEmpName 人员姓名 └ account_id Number 123 账号id organizations Organization [] 所在组织列表 base_properties OrganizationBaseProperties 组织基础属性值 └ alias String 1 组织别名 └ short_name String "" 组织简称 └ full_name String "" 组织全称 org_type Label 组织类型 └ code String "" 组织类型 supervisors Employee [] 组织主管员工列表 └ status String A 员工状态 └ employee_name String xx 员工Name └ employee_code String xx 员工Code └ default_type_name String 组织组织基础类型Name └ default_type_code String ORG 组织基础类型Code └ parent_name String 测试租户父组织Name └ parent_code String 476ee3ef-b91f-4f95-a18a-71e5cde3e168 父组织Code └ display_order Number 0 组织序号 └ organization_name String testorg 组织Name └ organization_code String 测试组织组织Code └ api_success Boolean true 是否成功 └ api_request_id String d888e21a-2586-4351-a6f3-98967f9201f5 request_id └ response_message String OK response_message └ response_code String 0 response_code

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaMoziVdsEmployeeOrganizationsBatchlistRequest req = new AlibabaMoziVdsEmployeeOrganizationsBatchlistRequest();
AlibabaMoziVdsEmployeeOrganizationsBatchlistRequest.BatchListEmployeeOrganizationsRequest obj1 = new AlibabaMoziVdsEmployeeOrganizationsBatchlistRequest.BatchListEmployeeOrganizationsRequest();
obj1.setNeedBaseProperties(false);
obj1.setNeedSupervisor(false);
obj1.setEmployeeCodes("emp1");
obj1.setAccountIds(new Long[] { 23 };
);
obj1.setTenantId(10000035003L);
req.setParam0(obj1);
AlibabaMoziVdsEmployeeOrganizationsBatchlistResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaMoziVdsEmployeeOrganizationsBatchlistRequest req = new AlibabaMoziVdsEmployeeOrganizationsBatchlistRequest();
AlibabaMoziVdsEmployeeOrganizationsBatchlistRequest.BatchListEmployeeOrganizationsRequestDomain obj1 = new AlibabaMoziVdsEmployeeOrganizationsBatchlistRequest.BatchListEmployeeOrganizationsRequestDomain();
obj1.NeedBaseProperties = false;
obj1.NeedSupervisor = false;
obj1.EmployeeCodes = "emp1";
obj1.AccountIds = new long[] { 23 };
;
obj1.TenantId = 10000035003L;
req.Param0_ = obj1;
AlibabaMoziVdsEmployeeOrganizationsBatchlistResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaMoziVdsEmployeeOrganizationsBatchlistRequest;
$param0 = new BatchListEmployeeOrganizationsRequest;
$param0->need_base_properties="false";
$param0->need_supervisor="false";
$param0->employee_codes="emp1";
$param0->account_ids="23";
$param0->tenant_id="10000035003";
$req->setParam0(json_encode($param0));
$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.mozi.vds.employee.organizations.batchlist' \
-d 'partner_id=apidoc' \
-d 'sign=69DCEB277E5C2BB054F23DB83909A12A' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-06-26+04%3A16%3A25' \
-d 'v=2.0' \
-d 'param0=null'

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

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

req.param0="数据结构示例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.mozi.vds.employee.organizations.batchlist");
add_param(pRequest,"param0","数据结构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.mozi.vds.employee.organizations.batchlist', {
	'param0':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_mozi_vds_employee_organizations_batchlist_response>
    <result>
        <datas>
            <employee_organizations>
                <employee_code>testEmpCode</employee_code>
                <employee_name>testEmpName</employee_name>
                <account_id>123</account_id>
                <organizations>
                    <organization>
                        <base_properties>
                            <alias>1</alias>
                            <short_name>&quot;&quot;</short_name>
                            <full_name>&quot;&quot;</full_name>
                            <org_type>
                                <code>&quot;&quot;</code>
                            </org_type>
                        </base_properties>
                        <supervisors>
                            <employee>
                                <status>A</status>
                                <employee_name>xx</employee_name>
                                <employee_code>xx</employee_code>
                            </employee>
                        </supervisors>
                        <default_type_name>组织</default_type_name>
                        <default_type_code>ORG</default_type_code>
                        <parent_name>测试租户</parent_name>
                        <parent_code>476ee3ef-b91f-4f95-a18a-71e5cde3e168</parent_code>
                        <display_order>0</display_order>
                        <organization_name>testorg</organization_name>
                        <organization_code>测试组织</organization_code>
                    </organization>
                </organizations>
            </employee_organizations>
        </datas>
        <api_success>true</api_success>
        <api_request_id>d888e21a-2586-4351-a6f3-98967f9201f5</api_request_id>
        <response_message>OK</response_message>
        <response_code>0</response_code>
    </result>
</alibaba_mozi_vds_employee_organizations_batchlist_response>

{
    "alibaba_mozi_vds_employee_organizations_batchlist_response":{
        "result":{
            "datas":{
                "employee_organizations":[
                    {
                        "employee_code":"testEmpCode",
                        "employee_name":"testEmpName",
                        "account_id":123,
                        "organizations":{
                            "organization":[
                                {
                                    "base_properties":{
                                        "alias":"1",
                                        "short_name":"\"\"",
                                        "full_name":"\"\"",
                                        "org_type":{
                                            "code":"\"\""
                                        }
                                    },
                                    "supervisors":{
                                        "employee":[
                                            {
                                                "status":"A",
                                                "employee_name":"xx",
                                                "employee_code":"xx"
                                            }
                                        ]
                                    },
                                    "default_type_name":"组织",
                                    "default_type_code":"ORG",
                                    "parent_name":"测试租户",
                                    "parent_code":"476ee3ef-b91f-4f95-a18a-71e5cde3e168",
                                    "display_order":0,
                                    "organization_name":"testorg",
                                    "organization_code":"测试组织"
                                }
                            ]
                        }
                    }
                ]
            },
            "api_success":true,
            "api_request_id":"d888e21a-2586-4351-a6f3-98967f9201f5",
            "response_message":"OK",
            "response_code":"0"
        }
    }
}

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下载

MOZI 租户

alibaba.mozi.vds.employee.organizations.batchlist (批量查询员工所在组织列表)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

用户导航

用户反馈

用户反馈

用户反馈