淘宝开放平台

登录
文档中心 > API类目 > 天猫校园零售

天猫校园零售

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

查询tp下的门店列表

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
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
1
2
3
4
5
6
7
8
9
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());

响应示例

  • 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
<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>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

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

如何获得此API

FAQ

我要提问
返回
顶部