淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
param_open_store_model_query_request	OpenStoreModelQueryRequest	必须			请求
└ biz_domain String 必须基础域基础域 └ biz_scene String 必须场景场景 └ biz_scope String 必须业务域业务域 └ request_id String 必须请求id 请求id store_unique_info StoreUniqueInfo 必须主键信息 └ store_unique_id String 必须门店id 门店id └ store_unique_type String 必须类型类型

名称	类型	示例值	描述
result	SingleQueryResult	响应体	响应体
└ result_code String 001 错误码 └ result_message String 失败错误信息 └ success Boolean success 是否成功 value StoreModel 返回模型响应体 store Store 基础模型基础模型 └ biz_channel String 渠道渠道 └ biz_outer_id String 2020072300077000000099059901 门店id └ biz_principal_id String 2088xxx pid └ biz_source String KOUBEI 来源 brand Brand 品牌信息品牌信息 └ brand_id String 1111 品牌信息id └ brand_name String 肯德基品牌信息名称 category_list Category [] 类目类目 └ category_id String 111 类目id └ name String asdd 类名称 └ parent_category_id String 222 上级类目id └ root_category_id String 333 根类目id └ cover String 1 封面图 └ gmt_create Date 创建时间创建时间 └ gmt_modified Date 修改时间修改时间 localization Localization 地理位置地理位置 └ address String 地址地址 └ address_memo String 地址备注地址备注 └ business_area_id String 区域id 系统自动生成 └ latitude String 123.123 经纬度 └ longitude String 88.123 经纬度 region Region 区域信息区域信息 └ city_id String 123 城市id └ city_name String 上海城市名 └ country_id String 1 国家id └ country_name String 中国国家名 └ district_id String 123 区域id └ district_name String 普陀区区域名 └ province_id String 1 省份id └ province_name String 上海省份名 └ mobile_no_list String [] 180xxx 联系电话 └ name String 肯德基门店名 └ status String 状态状态 store_business_info StoreBusinessInfo 营业信息营业信息 └ business_status String OPEN 营业状态 business_time StoreBusinessTime 营业时间营业时间 └ business_time_text String 每周一到周五营业时间文本 normal_business_time_list NormalBusinessTime [] 正常营业时间正常营业时间 business_hour BusinessHour 12 小时 └ cross_day Boolean true 是否跨天 └ ranges String [] 范围范围 └ type Number 类型类型 └ weeks Number [] 星期列表星期列表 └ mode Number 模式模式 └ months Number [] 月份月份 special_business_time_list SpecialBusinessTime [] 特殊营业时间特殊营业时间 business_hour BusinessHour 小时小时 └ cross_day Boolean 是否跨天是否跨天 └ ranges String [] 范围范围 └ type Number 类型类型 └ weeks Number [] 星期星期 date_range DateRange 天范围天范围 └ end_day Number 21 结束日期 └ end_month Number 12 结束月份 └ end_year Number 2023 结束年份 └ start_day Number 12 开始日期 └ start_month Number 12 开始月份 └ start_year Number 2019 开始年份 └ mode Number 模式模式 └ store_id Number 123123 门店id └ store_type String common 门店类型 └ test Boolean false 是否测试 └ valid_status String valid 有效性状态 store_extends_info AlscStoreExtendsInfo 扩展信息扩展信息 store_tags AlscStoreTagInfo [] 服务标签服务标签 └ tag_desc String 有停车位描述 └ tag_source String 口碑来源 └ tag_type String service 类型 └ tag_value String 停车位值 store_statistics_info StoreStatisticsInfo 统计信息统计信息 └ avg_price String 123 人均消费 └ recent_order_num Number 1111 最近单数 └ service_rating String 4.5 星级分

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAlscStoreDetailRequest req = new AlibabaAlscStoreDetailRequest();
AlibabaAlscStoreDetailRequest.OpenStoreModelQueryRequest obj1 = new AlibabaAlscStoreDetailRequest.OpenStoreModelQueryRequest();
obj1.setBizDomain("基础域");
obj1.setBizScene("场景");
obj1.setBizScope("业务域");
obj1.setRequestId("请求id");
AlibabaAlscStoreDetailRequest.StoreUniqueInfo obj2 = new AlibabaAlscStoreDetailRequest.StoreUniqueInfo();
obj2.setStoreUniqueId("门店id");
obj2.setStoreUniqueType("类型");
obj1.setStoreUniqueInfo(obj2);
req.setParamOpenStoreModelQueryRequest(obj1);
AlibabaAlscStoreDetailResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaAlscStoreDetailRequest req = new AlibabaAlscStoreDetailRequest();
AlibabaAlscStoreDetailRequest.OpenStoreModelQueryRequestDomain obj1 = new AlibabaAlscStoreDetailRequest.OpenStoreModelQueryRequestDomain();
obj1.BizDomain = "基础域";
obj1.BizScene = "场景";
obj1.BizScope = "业务域";
obj1.RequestId = "请求id";
AlibabaAlscStoreDetailRequest.StoreUniqueInfoDomain obj2 = new AlibabaAlscStoreDetailRequest.StoreUniqueInfoDomain();
obj2.StoreUniqueId = "门店id";
obj2.StoreUniqueType = "类型";
obj1.StoreUniqueInfo= obj2;
req.ParamOpenStoreModelQueryRequest_ = obj1;
AlibabaAlscStoreDetailResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaAlscStoreDetailRequest;
$param_open_store_model_query_request = new OpenStoreModelQueryRequest;
$param_open_store_model_query_request->biz_domain="基础域";
$param_open_store_model_query_request->biz_scene="场景";
$param_open_store_model_query_request->biz_scope="业务域";
$param_open_store_model_query_request->request_id="请求id";
$store_unique_info = new StoreUniqueInfo;
$store_unique_info->store_unique_id="门店id";
$store_unique_info->store_unique_type="类型";
$param_open_store_model_query_request->store_unique_info = $store_unique_info;
$req->setParamOpenStoreModelQueryRequest(json_encode($param_open_store_model_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.alsc.store.detail' \
-d 'partner_id=apidoc' \
-d 'sign=25ABAF499C900862CEEE0D24AC2B31E1' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-16+19%3A50%3A51' \
-d 'v=2.0' \
-d 'param_open_store_model_query_request=null'

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

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

req.param_open_store_model_query_request=""
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.alsc.store.detail");
add_param(pRequest,"param_open_store_model_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',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('alibaba.alsc.store.detail', {
	'param_open_store_model_query_request':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_alsc_store_detail_response>
    <result>
        <result_code>001</result_code>
        <result_message>失败</result_message>
        <success>success</success>
        <value>
            <store>
                <biz_channel>渠道</biz_channel>
                <biz_outer_id>2020072300077000000099059901</biz_outer_id>
                <biz_principal_id>2088xxx</biz_principal_id>
                <biz_source>KOUBEI</biz_source>
                <brand>
                    <brand_id>1111</brand_id>
                    <brand_name>肯德基</brand_name>
                </brand>
                <category_list>
                    <category>
                        <category_id>111</category_id>
                        <name>asdd</name>
                        <parent_category_id>222</parent_category_id>
                        <root_category_id>333</root_category_id>
                    </category>
                </category_list>
                <cover>1</cover>
                <gmt_create>创建时间</gmt_create>
                <gmt_modified>修改时间</gmt_modified>
                <localization>
                    <address>地址</address>
                    <address_memo>地址备注</address_memo>
                    <business_area_id>区域id</business_area_id>
                    <latitude>123.123</latitude>
                    <longitude>88.123</longitude>
                    <region>
                        <city_id>123</city_id>
                        <city_name>上海</city_name>
                        <country_id>1</country_id>
                        <country_name>中国</country_name>
                        <district_id>123</district_id>
                        <district_name>普陀区</district_name>
                        <province_id>1</province_id>
                        <province_name>上海</province_name>
                    </region>
                </localization>
                <mobile_no_list>
                    <string>180xxx</string>
                </mobile_no_list>
                <name>肯德基</name>
                <status>状态</status>
                <store_business_info>
                    <business_status>OPEN</business_status>
                    <business_time>
                        <business_time_text>每周一到周五</business_time_text>
                        <normal_business_time_list>
                            <normal_business_time>
                                <business_hour>
                                    <cross_day>true</cross_day>
                                    <ranges>
                                        <string>范围</string>
                                    </ranges>
                                    <type>类型</type>
                                    <weeks>
                                        <number>星期列表</number>
                                    </weeks>
                                </business_hour>
                                <mode>模式</mode>
                                <months>
                                    <number>月份</number>
                                </months>
                            </normal_business_time>
                        </normal_business_time_list>
                        <special_business_time_list>
                            <special_business_time>
                                <business_hour>
                                    <cross_day>是否跨天</cross_day>
                                    <ranges>
                                        <string>范围</string>
                                    </ranges>
                                    <type>类型</type>
                                    <weeks>
                                        <number>星期</number>
                                    </weeks>
                                </business_hour>
                                <date_range>
                                    <end_day>21</end_day>
                                    <end_month>12</end_month>
                                    <end_year>2023</end_year>
                                    <start_day>12</start_day>
                                    <start_month>12</start_month>
                                    <start_year>2019</start_year>
                                </date_range>
                                <mode>模式</mode>
                            </special_business_time>
                        </special_business_time_list>
                    </business_time>
                </store_business_info>
                <store_id>123123</store_id>
                <store_type>common</store_type>
                <test>false</test>
                <valid_status>valid</valid_status>
            </store>
            <store_extends_info>
                <store_tags>
                    <alsc_store_tag_info>
                        <tag_desc>有停车位</tag_desc>
                        <tag_source>口碑</tag_source>
                        <tag_type>service</tag_type>
                        <tag_value>停车位</tag_value>
                    </alsc_store_tag_info>
                </store_tags>
            </store_extends_info>
            <store_statistics_info>
                <avg_price>123</avg_price>
                <recent_order_num>1111</recent_order_num>
                <service_rating>4.5</service_rating>
            </store_statistics_info>
        </value>
    </result>
</alibaba_alsc_store_detail_response>

{
    "alibaba_alsc_store_detail_response":{
        "result":{
            "result_code":"001",
            "result_message":"失败",
            "success":success,
            "value":{
                "store":{
                    "biz_channel":"渠道",
                    "biz_outer_id":"2020072300077000000099059901",
                    "biz_principal_id":"2088xxx",
                    "biz_source":"KOUBEI",
                    "brand":{
                        "brand_id":"1111",
                        "brand_name":"肯德基"
                    },
                    "category_list":{
                        "category":[
                            {
                                "category_id":"111",
                                "name":"asdd",
                                "parent_category_id":"222",
                                "root_category_id":"333"
                            }
                        ]
                    },
                    "cover":"1",
                    "gmt_create":"创建时间",
                    "gmt_modified":"修改时间",
                    "localization":{
                        "address":"地址",
                        "address_memo":"地址备注",
                        "business_area_id":"区域id",
                        "latitude":"123.123",
                        "longitude":"88.123",
                        "region":{
                            "city_id":"123",
                            "city_name":"上海",
                            "country_id":"1",
                            "country_name":"中国",
                            "district_id":"123",
                            "district_name":"普陀区",
                            "province_id":"1",
                            "province_name":"上海"
                        }
                    },
                    "mobile_no_list":{
                        "string":[
                            "180xxx"
                        ]
                    },
                    "name":"肯德基",
                    "status":"状态",
                    "store_business_info":{
                        "business_status":"OPEN",
                        "business_time":{
                            "business_time_text":"每周一到周五",
                            "normal_business_time_list":{
                                "normal_business_time":[
                                    {
                                        "business_hour":{
                                            "cross_day":true,
                                            "ranges":{
                                                "string":[
                                                    "范围"
                                                ]
                                            },
                                            "type":类型,
                                            "weeks":{
                                                "number":[
                                                    星期列表
                                                ]
                                            }
                                        },
                                        "mode":模式,
                                        "months":{
                                            "number":[
                                                月份
                                            ]
                                        }
                                    }
                                ]
                            },
                            "special_business_time_list":{
                                "special_business_time":[
                                    {
                                        "business_hour":{
                                            "cross_day":是否跨天,
                                            "ranges":{
                                                "string":[
                                                    "范围"
                                                ]
                                            },
                                            "type":类型,
                                            "weeks":{
                                                "number":[
                                                    星期
                                                ]
                                            }
                                        },
                                        "date_range":{
                                            "end_day":21,
                                            "end_month":12,
                                            "end_year":2023,
                                            "start_day":12,
                                            "start_month":12,
                                            "start_year":2019
                                        },
                                        "mode":模式
                                    }
                                ]
                            }
                        }
                    },
                    "store_id":123123,
                    "store_type":"common",
                    "test":false,
                    "valid_status":"valid"
                },
                "store_extends_info":{
                    "store_tags":{
                        "alsc_store_tag_info":[
                            {
                                "tag_desc":"有停车位",
                                "tag_source":"口碑",
                                "tag_type":"service",
                                "tag_value":"停车位"
                            }
                        ]
                    }
                },
                "store_statistics_info":{
                    "avg_price":"123",
                    "recent_order_num":1111,
                    "service_rating":"4.5"
                }
            }
        }
    }
}

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.alsc.store.detail (门店模型查询)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ