腾讯有数官方文档

获取门店仓库

请求地址

stores/get

请求方法

GET

请求参数

名称 类型 描述
account_id 必填 integer

推广帐号 id ,有操作权限的帐号 id,包括代理商和广告主帐号id

data_warehouse_id 必填 integer

数据仓库ID

external_store_id 必填 string

您为仓库分配的唯一ID。 一般而言,是您在商品库为该仓库分配的id。

字段长度最小 1 字节,长度最大 32 字节

请求示例

curl -G 'https://api.e.qq.com/v1.1/stores/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id="<ACCOUNT_ID>"' \
-d 'data_warehouse_id=101' \
-d 'external_store_id="大小写字母数字下划线100000001"'

应答字段

名称 类型 描述
list struct[]

返回仓库列表

数组最大长度 50
external_store_id 必填 string

您为仓库分配的唯一ID。 一般而言,是您在商品库为该仓库分配的id。

字段长度最小 1 字节,长度最大 32 字节
name 必填 string

仓库名称

字段长度最小 1 字节,长度最大 32 字节
type enum

仓库类型

枚举列表:{ SHOP、WAREHOUSE、EC_WAREHOUSE }
operation_status enum

运营状态

枚举列表:{ OPEN、CLOSE、SUSPEND }
daojia_operation_status enum

运营状态

枚举列表:{ OPEN、CLOSE、SUSPEND }
phone_numbers string[]

电话号列表

location_info struct

地址信息

country_code string

国家编码

字段长度最小 1 字节,长度最大 64 字节
country_name string

国家名称

字段长度最小 1 字节,长度最大 64 字节
province_code integer

省份编码

province_name string

省份名称

字段长度最小 1 字节,长度最大 64 字节
city_code integer

城市编码

city_name string

城市名称

字段长度最小 1 字节,长度最大 64 字节
district_code integer

行政区编码

district_name string

行政区名称

字段长度最小 1 字节,长度最大 64 字节
address string

地址

字段长度最小 1 字节,长度最大 64 字节
geo_info struct[]

坐标信息

geo_type 必填 enum

坐标类型

枚举列表:{ BAIDU、GAODE、STANDARD }
latitude 必填 float

纬度

longitude 必填 float

经度

basic_props struct

基础信息

operating_time_zones struct[]

营业时间段列表

date_zone 必填 string

日期区间

字段长度最小 1 字节,长度最大 64 字节
time_zone 必填 string

时间区间

字段长度最小 1 字节,长度最大 64 字节
daojia_operating_time_zones struct[]

到家业务营业时间段列表

date_zone 必填 string

日期区间

字段长度最小 1 字节,长度最大 64 字节
time_zone 必填 string

时间区间

字段长度最小 1 字节,长度最大 64 字节
logo struct

单个图片信息,包含URL,宽,高,说明等

img_url string

url类型,长度不超过2048

字段长度最小 1 字节,长度最大 2048 字节
width integer

图片宽度,整型值

height integer

图片高度,整型值

img_desc string

图片描述

字段长度最小 1 字节,长度最大 100 字节
delivery_info struct

配送信息

delivery_range_type enum

配送范围类型

枚举列表:{ CIRCLE、VERTEXES、VERTEXES_GROUP }
radius string

配送半径

字段长度最小 1 字节,长度最大 128 字节
geo_group array[]

坐标信息组合,坐标点的二维数组,表示多个形状

应答示例

{
    "code": 0,
    "message": "",
    "data": {
        "list": [
            {
                "data_warehouse_id": 101,
                "external_store_id": "大小写字母数字下划线100000001",
                "name": "银科1店",
                "type": "SHOP",
                "operation_status": "OPEN",
                "daojia_operation_status": "OPEN",
                "open_time": "2016-11-01 10:42:56",
                "phone_numbers": [
                    "13677778888"
                ],
                "location_info": {
                    "country_code": "CNN",
                    "country_name": "中国",
                    "province_code": 110000,
                    "province_name": "北京",
                    "city_code": 110100,
                    "city_name": "北京市",
                    "district_code": 110101,
                    "district_name": "西城区",
                    "zip_code": "110101",
                    "poi": "细化到楼栋",
                    "tmc_name": "华北大区",
                    "tmc_code": "D001",
                    "location_type": "OFFICE_BUILDING",
                    "address": "银科大厦111",
                    "business_area_type": "OFFICE",
                    "floor": "1-4",
                    "geo_info": [
                        {
                            "geo_type": "BAIDU",
                            "latitude": 23.31,
                            "longitude": 108.22
                        }
                    ]
                },
                "basic_props": {
                    "area_size": 2000,
                    "brand_name": "永辉",
                    "decoration_time": "2016-11-01 10:42:56",
                    "level": 1,
                    "door_width": "3m",
                    "manage_type": "DIRECT",
                    "operating_time_zones": [
                        {
                            "date_zone": "周一至周五",
                            "time_zone": "8:00-17:00"
                        },
                        {
                            "date_zone": "法定节假日",
                            "time_zone": "8:00-19:00"
                        }
                    ],
                    "daojia_operating_time_zones": [
                        {
                            "date_zone": "周一至周五",
                            "time_zone": "8:00-17:00"
                        },
                        {
                            "date_zone": "法定节假日",
                            "time_zone": "8:00-19:00"
                        }
                    ]
                },
                "extra_props": {
                    "key1": "value1"
                },
                "delivery_info": {
                    "delivery_range_type": "VERTEXES",
                    "radius": "3km",
                    "delivery_description": "海淀区内",
                    "geos": [
                        {
                            "geo_type": "STANDARD",
                            "latitude": 23.31,
                            "longitude": 108.22
                        }
                    ],
                    "range_address": "range_address",
                    "store_priority": 1
                },
                "shop_store_list": [
                    "D001",
                    "D002"
                ],
                "description": "description"
            }
        ]
    }
}