店铺分页查询接口

用于服务商或商户查询其自己的店铺信息

{ "shop_infos": [ { "business_address": { "address": "string", "city_code": "string", "district_code": "string", "latitude": "string", "longitude": "string", "poiid": "string", "province_code": "string", "type": "string" }, "business_time": [ { "close_time": "string", "open_time": "string", "week_day": 0 } ], "contact_mobile": "13901390139", "contact_phone": "010-62286228", "new_shop_category": "B0001", "shop_category": "1001", "shop_id": "2018011900502000000005124744", "shop_info_status": "01", "shop_name": "支付宝东门小卖铺", "shop_status": "01", "shop_type": "01", "store_id": "NO0001" } ], "total_pages": 10 }

请求参数

Query 参数

ip_role_id

string

可选

商户角色id，表示将要开的店属于哪个商户角色。对于直连开店场景，填写商户pid；对于间连开店场景（线上、线下、直付通），填写商户smid。特别说明：IoT设备三绑定场景统一填写商户pid

page_num

integer

查询页数

可选

page_size

integer

可选

每页查询大小，限制100以内

address_version

string

可选

行政区划版本，当前可传空值(取默认版本)、2022Q2、UPTODATE(取最新版本)，其中空值默认为：2020Q1版本(address_version=''或null)，想要查看版本是2022年2季度版本则传入:(address_version='2022Q2')，想要获取最新版本则传入:(address_version ='UPTODATE')

返回响应

🟢200common response

application/json

Body

shop_infos

array[object (ShopQueryOpenApiVO) {12}]

门店详情

可选

business_address

object (AddressInfo)

可选

business_time

array[object (ShopBusinessTime) {3}]

店铺经营时间

可选

contact_mobile

string

店铺联系手机

可选

示例值:

13901390139

contact_phone

string

店铺的联系固话

可选

示例值:

010-62286228

new_shop_category

string

可选

新版门店类目标准二级类目code。类目标准及与原shop_category映射关系参见文档https://gw.alipayobjects.com/os/bmw-prod/4b3f82df-e53e-4b84-bc41-fe025101e726.xlsx

示例值:

B0001

shop_category

string

可选

店铺类目，取值参见文件https://mif-pub.alipayobjects.com/ShopCategory.xlsx 中的三级门店类目

示例值:

1001

shop_id

string

蚂蚁店铺id

可选

示例值:

2018011900502000000005124744

shop_info_status

string

可选

当前名称、地址、经纬度信息准确一致，可用于数字化经营场景消费（01=已认证,02=待优化,03=审核中,99=未知）

示例值:

shop_name

string

店铺名称

可选

示例值:

支付宝东门小卖铺

shop_status

string

门店状态

可选

示例值:

shop_type

string

店铺经营类型

可选

示例值:

store_id

string

可选

门店编号，表示该门店在该商户角色id(直连pid，间连smid)下，由商户自己定义的外部门店编号

示例值:

NO0001

total_pages

integer

总页数

可选

示例值:

🔴500请求失败