淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
shop_detail_query_top_request	ShopDetailQueryTopRequest	可选			请求体
└ principal_id String 可选 2088001969784501 使用者主体id └ op_role String 可选 MERCHANT或PROVIDER 服务商及商户调用情况下务必传递。操作人角色，默认商户操作:MERCHANT；服务商操作：PROVIDER；ISV: 不需要填写 └ store_id String 可选 1067026148 淘宝门店id └ shop_id String 可选 2015052100077000000000120773 支付宝门店ID └ invoke_principal_id String 可选 2088001969784501 调用者主体id

名称	类型	示例值	描述
result	TopResult		返回结果
└ success Boolean true 是否成功 └ result_code String SYSTEM_ERROR 错误码 value ShopDetailQueryResponse 业务结果数据 └ audit_status String AUDITING 门店审核状态，对于系统商而言，只有三个状态，AUDITING：审核中，AUDIT_FAILED：审核驳回，AUDIT_SUCCESS：审核通过。第一次审核通过会触发门店上架。 └ audit_desc String 门店首图不符合规范门店审核状态描述，如果审核驳回则有相关的驳回理由 └ is_online String T 门店是否上架，T表示上架,F表示未上架，第一次门店审核通过后会触发上架 └ is_show String T 门店是否在客户端显示，T表示显示，F表示隐藏 └ category_id String 203 类目ID，类目初始数据由口碑提供 └ brand_name String 其它品牌品牌名称；不填写则默认为“其它品牌” └ brand_logo String hOTQ1lT1TtOjcxGflvnUXgAAACMAAQED 品牌LOGO; 图片ID，不填写则默认为门店首图main_image └ main_shop_name String 肯德基主店名；比如：肯德基 └ branch_shop_name String 万塘路店分店名称，比如：万塘路店，与主门店名合并在客户端显示为：肯德基(万塘路店) └ province_code String 330000 省份编码，国标码，详见国家统计局数据 └ city_code String 330100 城市编码，国标码，详见国家统计局数据 └ district_code String 330101 区县编码，国标码，详见国家统计局数据 └ address String 万塘路18号黄龙时代广场门店详细地址，注：不含省市区 └ longitude String 104.08296 经度，最长15位字符（包括小数点），注：高德坐标系 └ latitude String 38.65777 纬度，最长15位字符（包括小数点），注：高德坐标系 └ contact_number String 057126888888,18666668888 门店电话号码；支持座机和手机，在客户端对用户展现，支持多个电话，以英文逗号分隔 └ extern_store_id String hz001 外部门店编号；最长54位字符，该编号将作为收单接口的入参，请开发者自行确保其唯一性 └ main_image String AM-uJRh2SRKz9N0r9zW4wQAAACMAAQEC 门店首图；非常重要，推荐尺寸2000*1500 └ audit_images String fTwPcLSxSa2VdNag2PqeKQAAACMAAQEC,bGG2pMF-SAGY444rjAEVigAAACMAAQEC 门店审核时需要的图片; 至少包含一张门头照片，两张内景照片，必须反映真实的门店情况，审核才能够通过，多个以英文逗号分隔 └ business_time String 10:00-23:00 营业时间;支持分段营业时间，以英文逗号分隔 └ licence String AM-uJRh2SRKz9N0r9zW4wQAAACMAAQEC 门店营业执照图片 └ licence_code String 4406xxx 门店营业执照编号 └ licence_name String 杭州市西湖区万塘路支小宝美甲店门店营业执照名称 └ auth_letter String AM-uJRh2SRKz9N0r9zW4wQAAACMAAQEC 授权函图片 └ implement_id String HA111,HA112 店铺使用的机具编号，多个以英文逗号分隔 └ pic_coll String {"IUFIDASFIEUIOFKSFIUFE83IEI":"http://object.alipay.com/getpic.do?kjkdjkjj"} 图片集，是map转化成的json串，key是图片id,value是图片url └ business_certificate String hdYiHK85fHks 经营许可证，只有餐饮类目需要 └ business_certificate_expires String 长期经营许可证有效期，格式：2020-03-20，只有餐饮类目需要 └ licence_expires String 20200101 或长期营业执照过期时间 └ partner_id String 2088101117656381 门店的签约ID └ pay_type String 付款码默认付款类型；如：付款码、扫码付、声波支付、在线买单、其它 └ create_channel String 开放平台门店创建来源；如：开放平台、支付宝客户端、口碑商家app、商家自主开店、服务商开店、全民开店-支付宝客户端、全民开店-商户app、其它 └ other_auth_images String AM-uJRh2SRKz9N0r9zW4wQAAACMAAQEC 其它资质证明图片集；支持多张，逗号分隔 └ gmt_shop_create String 2016-03-13 16:56:45 门店创建时间 └ gmt_shop_modified String 2016-03-13 16:56:45 门店修改时间 └ alsc_store_id String 1067028102 本地生活门店id └ error_msg String 系统异常错误文案 └ ext_info String 扩展字段

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAlscShopQuerydetailRequest req = new AlibabaAlscShopQuerydetailRequest();
AlibabaAlscShopQuerydetailRequest.ShopDetailQueryTopRequest obj1 = new AlibabaAlscShopQuerydetailRequest.ShopDetailQueryTopRequest();
obj1.setPrincipalId("2088001969784501");
obj1.setOpRole("MERCHANT或PROVIDER");
obj1.setStoreId("1067026148");
obj1.setShopId("2015052100077000000000120773");
obj1.setInvokePrincipalId("2088001969784501");
req.setShopDetailQueryTopRequest(obj1);
AlibabaAlscShopQuerydetailResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

XML示例
JSON示例

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

<alibaba_alsc_shop_querydetail_response>
    <result>
        <success>true</success>
        <result_code>SYSTEM_ERROR</result_code>
        <value>
            <audit_status>AUDITING</audit_status>
            <audit_desc>门店首图不符合规范</audit_desc>
            <is_online>T</is_online>
            <is_show>T</is_show>
            <category_id>203</category_id>
            <brand_name>其它品牌</brand_name>
            <brand_logo>hOTQ1lT1TtOjcxGflvnUXgAAACMAAQED</brand_logo>
            <main_shop_name>肯德基</main_shop_name>
            <branch_shop_name>万塘路店</branch_shop_name>
            <province_code>330000</province_code>
            <city_code>330100</city_code>
            <district_code>330101</district_code>
            <address>万塘路18号黄龙时代广场</address>
            <longitude>104.08296</longitude>
            <latitude>38.65777</latitude>
            <contact_number>057126888888,18666668888</contact_number>
            <extern_store_id>hz001</extern_store_id>
            <main_image>AM-uJRh2SRKz9N0r9zW4wQAAACMAAQEC</main_image>
            <audit_images>fTwPcLSxSa2VdNag2PqeKQAAACMAAQEC,bGG2pMF-SAGY444rjAEVigAAACMAAQEC</audit_images>
            <business_time>10:00-23:00</business_time>
            <licence>AM-uJRh2SRKz9N0r9zW4wQAAACMAAQEC</licence>
            <licence_code>4406xxx</licence_code>
            <licence_name>杭州市西湖区万塘路支小宝美甲店</licence_name>
            <auth_letter>AM-uJRh2SRKz9N0r9zW4wQAAACMAAQEC</auth_letter>
            <implement_id>HA111,HA112</implement_id>
            <pic_coll>{&quot;IUFIDASFIEUIOFKSFIUFE83IEI&quot;:&quot;http://object.alipay.com/getpic.do?kjkdjkjj&quot;}</pic_coll>
            <business_certificate>hdYiHK85fHks</business_certificate>
            <business_certificate_expires>长期</business_certificate_expires>
            <licence_expires>20200101 或长期</licence_expires>
            <partner_id>2088101117656381</partner_id>
            <pay_type>付款码</pay_type>
            <create_channel>开放平台</create_channel>
            <other_auth_images>AM-uJRh2SRKz9N0r9zW4wQAAACMAAQEC</other_auth_images>
            <gmt_shop_create>2016-03-13 16:56:45</gmt_shop_create>
            <gmt_shop_modified>2016-03-13 16:56:45</gmt_shop_modified>
            <alsc_store_id>1067028102</alsc_store_id>
        </value>
        <error_msg>系统异常</error_msg>
    </result>
</alibaba_alsc_shop_querydetail_response>

{
    "alibaba_alsc_shop_querydetail_response":{
        "result":{
            "success":true,
            "result_code":"SYSTEM_ERROR",
            "value":{
                "audit_status":"AUDITING",
                "audit_desc":"门店首图不符合规范",
                "is_online":"T",
                "is_show":"T",
                "category_id":"203",
                "brand_name":"其它品牌",
                "brand_logo":"hOTQ1lT1TtOjcxGflvnUXgAAACMAAQED",
                "main_shop_name":"肯德基",
                "branch_shop_name":"万塘路店",
                "province_code":"330000",
                "city_code":"330100",
                "district_code":"330101",
                "address":"万塘路18号黄龙时代广场",
                "longitude":"104.08296",
                "latitude":"38.65777",
                "contact_number":"057126888888,18666668888",
                "extern_store_id":"hz001",
                "main_image":"AM-uJRh2SRKz9N0r9zW4wQAAACMAAQEC",
                "audit_images":"fTwPcLSxSa2VdNag2PqeKQAAACMAAQEC,bGG2pMF-SAGY444rjAEVigAAACMAAQEC",
                "business_time":"10:00-23:00",
                "licence":"AM-uJRh2SRKz9N0r9zW4wQAAACMAAQEC",
                "licence_code":"4406xxx",
                "licence_name":"杭州市西湖区万塘路支小宝美甲店",
                "auth_letter":"AM-uJRh2SRKz9N0r9zW4wQAAACMAAQEC",
                "implement_id":"HA111,HA112",
                "pic_coll":"{\"IUFIDASFIEUIOFKSFIUFE83IEI\":\"http:\/\/object.alipay.com\/getpic.do?kjkdjkjj\"}",
                "business_certificate":"hdYiHK85fHks",
                "business_certificate_expires":"长期",
                "licence_expires":"20200101 或长期",
                "partner_id":"2088101117656381",
                "pay_type":"付款码",
                "create_channel":"开放平台",
                "other_auth_images":"AM-uJRh2SRKz9N0r9zW4wQAAACMAAQEC",
                "gmt_shop_create":"2016-03-13 16:56:45",
                "gmt_shop_modified":"2016-03-13 16:56:45",
                "alsc_store_id":"1067028102"
            },
            "error_msg":"系统异常"
        }
    }
}

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>

错误码	错误描述	解决方案

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

本地生活API

alibaba.alsc.shop.querydetail (查询店铺详情)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ