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

请求地址：

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

名称	类型	是否必须	示例值	描述
tp_id	Number	必须	727189005	tp的storeId
store_id	Number	可选	727189006	门店的storeId
name	String	可选	门店name	门店name
page_num	Number	必须	1	分页页码
page_size	Number	必须	10	每页数量

名称	类型	示例值	描述
mesg	String	服务异常	错误描述
cod	String	SERVICE_ERROR	错误code
data	CampusStoreDTO []		返回值
└ tp_name String 企业名称企业名称 └ tp_short_ame String 企业简称企业简称 └ store_id Number 部门编码-storeId 部门编码-storeId └ store_name String 部门名称部门名称 └ type Number 部门类型部门类型 └ store_operate_area String 100m2 门店经营面积 └ status Number 0 门店营业状态:0-营业中;1-休息中;2-关店;4-停业中; └ posx String 118.385146 经度 └ posy String 31.340404 纬度 └ business_time String 08:30～12:00 营业时间 └ prov_code Number 340000 省编码 └ city_code Number 340200 市编码 └ district_code Number 340202 区编码 └ store_address String 详细地址详细地址 └ pic String 门店图url 门店图url └ contact_phone String 13912345678 联系人电话 └ contact_name String 张三联系人姓名
total_num	String	10	总数
succes	String	true	是否成功
page_num	String	1	页码

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallCampusRetailStoreQueryRequest req = new TmallCampusRetailStoreQueryRequest();
req.setTpId(727189005L);
req.setStoreId(727189006L);
req.setName("门店name");
req.setPageNum(1L);
req.setPageSize(10L);
TmallCampusRetailStoreQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TmallCampusRetailStoreQueryRequest req = new TmallCampusRetailStoreQueryRequest();
req.TpId = 727189005L;
req.StoreId = 727189006L;
req.Name = "门店name";
req.PageNum = 1L;
req.PageSize = 10L;
TmallCampusRetailStoreQueryResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TmallCampusRetailStoreQueryRequest;
$req->setTpId("727189005");
$req->setStoreId("727189006");
$req->setName("门店name");
$req->setPageNum("1");
$req->setPageSize("10");
$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=tmall.campus.retail.store.query' \
-d 'partner_id=apidoc' \
-d 'sign=4AD63C0A401F76CC91B81EE3F6324C0A' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-06-07+21%3A32%3A55' \
-d 'v=2.0' \
-d 'name=%E9%97%A8%E5%BA%97name' \
-d 'page_num=1' \
-d 'page_size=10' \
-d 'store_id=727189006' \
-d 'tp_id=727189005'

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

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

req.tp_id=727189005
req.store_id=727189006
req.name="门店name"
req.page_num=1
req.page_size=10
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,"tmall.campus.retail.store.query");
add_param(pRequest,"tp_id","727189005");
add_param(pRequest,"store_id","727189006");
add_param(pRequest,"name","门店name");
add_param(pRequest,"page_num","1");
add_param(pRequest,"page_size","10");
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('tmall.campus.retail.store.query', {
	'tp_id':'727189005',
	'store_id':'727189006',
	'name':'门店name',
	'page_num':'1',
	'page_size':'10'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<tmall_campus_retail_store_query_response>
    <mesg>服务异常</mesg>
    <cod>SERVICE_ERROR</cod>
    <data>
        <campus_store_d_t_o>
            <tp_name>企业名称</tp_name>
            <tp_short_ame>企业简称</tp_short_ame>
            <store_id>部门编码-storeId</store_id>
            <store_name>部门名称</store_name>
            <type>部门类型</type>
            <store_operate_area>100m2</store_operate_area>
            <status>0</status>
            <posx>118.385146</posx>
            <posy>31.340404</posy>
            <business_time>08:30～12:00</business_time>
            <prov_code>340000</prov_code>
            <city_code>340200</city_code>
            <district_code>340202</district_code>
            <store_address>详细地址</store_address>
            <pic>门店图url</pic>
            <contact_phone>13912345678</contact_phone>
            <contact_name>张三</contact_name>
        </campus_store_d_t_o>
    </data>
    <total_num>10</total_num>
    <succes>true</succes>
    <page_num>1</page_num>
</tmall_campus_retail_store_query_response>

{
    "tmall_campus_retail_store_query_response":{
        "mesg":"服务异常",
        "cod":"SERVICE_ERROR",
        "data":{
            "campus_store_d_t_o":[
                {
                    "tp_name":"企业名称",
                    "tp_short_ame":"企业简称",
                    "store_id":部门编码-storeId,
                    "store_name":"部门名称",
                    "type":部门类型,
                    "store_operate_area":"100m2",
                    "status":0,
                    "posx":"118.385146",
                    "posy":"31.340404",
                    "business_time":"08:30～12:00",
                    "prov_code":340000,
                    "city_code":340200,
                    "district_code":340202,
                    "store_address":"详细地址",
                    "pic":"门店图url",
                    "contact_phone":"13912345678",
                    "contact_name":"张三"
                }
            ]
        },
        "total_num":"10",
        "succes":"true",
        "page_num":"1"
    }
}

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

天猫校园零售

tmall.campus.retail.store.query (【天猫校园】-新零售-门店列表查询)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

用户导航

用户反馈

用户反馈

用户反馈