门店摘要信息批量查询接口

用于进行门店摘要信息批量查询接口。

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/offline/market/shop/summary/batchquery' \ --header 'Content-Type: application/json' \ --data-raw '{ "biz_channel": "POS、ALL", "brand_name": "麦当劳", "city_code": "120100", "district_code": "120104", "op_role": "ISV、PROVIDER", "page_no": 1, "page_size": 20, "province_code": "120000", "query_type": "BRAND_RELATION", "related_partner_id": "2088001969784501", "shop_id": "2015062100077000000000120773", "shop_status": "PAUSED" }'

{ "current_page_no": "1", "page_size": "20", "shop_summary_infos": [ { "shop_comment_info": { "avg_popularity": "76", "avg_popularity_name": "口碑人气", "score": "3.2", "star": "4.0" }, "address": "万塘路18号黄龙时代广场", "branch_shop_name": "万塘路店", "brand_name": "肯德基", "business_time": "10:00-14:00", "category_infos": [ { "category_id": "2015050700000018", "category_level": "2", "category_name": "美食" } ], "city_code": "140500", "district_code": "140521", "ext_info": "{\"order_biz_mode\":\"REGULAR\",\"order\":\"1\",\"pre_order\":\"1\"}", "is_show": "T", "latitude": "31.226948", "longitude": "121.549728", "main_image": "AM-uJRh2SRKz9N0r9zW4wQAAACMAAQEC", "main_shop_name": "海底捞", "per_pay": "100", "pic_coll": "{\"IUFIDASFIEUIOFKSFIUFE83IEI\":\"http://object.alipay.com/getpic.do?kjkdjkjj\"}", "province_code": "110000", "shop_id": "2015052100077000000000120773", "shop_type": "COMMON", "status": "OPEN", "gmt_create": {} } ], "total_items": "50", "total_page_no": "3" }

请求参数

Body 参数application/json

biz_channel

string

可选

表示接口查询门店的业务渠道限制：ALL、 POS、不传。不传代表只查询普通门店，传入POS代表只查询简易门店，传入ALL代表查询普通门店和简易门店。

示例值:

POS、ALL

brand_name

string

品牌名

可选

示例值:

麦当劳

city_code

string

可选

城市编码，国标码，如：120100表示天津市

示例值:

120100

district_code

string

可选

区域编码，如：120104表示南开区

示例值:

120104

op_role

string

可选

表示接口业务的调用方身份：ISV、服务商身份标识。传入ISV代表系统集成商身份。传入PROVIDER代表服务商。

示例值:

ISV、PROVIDER

page_no

integer

可选

页码，留空标示第一页，默认 20个结果为一页

示例值:

page_size

integer

可选

每页记录数，默认20，最大 100

示例值:

province_code

string

可选

省份编码，国标码，如：120000表示天津

示例值:

120000

query_type

string

可选

门店数据查询类型，根据类型可以返回指定的门店数据，目前支持的类型如下： BRAND_RELATION ：品牌商关联店铺 MALL_SELF ：MALL自己的门店 MALL_RELATION：MALL关联下的门店 MERCHANT_SELF:商户自己的门店 KB_PROMOTER：口碑客推广者

示例值:

BRAND_RELATION

related_partner_id

string

可选

query_type查询类型下所关联的商户PID

示例值:

2088001969784501

shop_id

string

门店ID

可选

示例值:

2015062100077000000000120773

shop_status

string

可选

门店状态，传入多个状态，多个状态使用英文逗号隔开，例如：PAUSED,OPEN 店铺状态：OPEN（营业）、PAUSED（暂停）、INIT（初始）、FREEZE（冻结）、CLOSED（关店）

示例值:

PAUSED

示例

返回响应

🟢200common response

application/json

Body

current_page_no

string

当前页码

可选

示例值:

page_size

string

每页记录数

可选

示例值:

shop_summary_infos

array[object (ShopSummaryQueryResponse) {21}]

可选

支付宝门店摘要信息列表

shop_comment_info

object (ShopCommentInfo)

可选

address

string

门店地址

可选

示例值:

万塘路18号黄龙时代广场

branch_shop_name

string

分店名

可选

示例值:

万塘路店

brand_name

string

可选

品牌名，不填写则默认为其它品牌

示例值:

肯德基

business_time

string

经营时间

可选

示例值:

10:00-14:00

category_infos

array[object (ShopCategoryInfo) {3}]

门店类目列表

可选

city_code

string

可选

城市编码，国标码，详见国家统计局数据点此下载

示例值:

140500

district_code

string

可选

区县编码，国标码，详见国家统计局数据点此下载

示例值:

140521

ext_info

string

可选

json 字符串表示额外信息;

order_biz_mode: 点餐营业模式, REGULAR-正餐、LIGHT_FAST-轻快餐; pre_order: 预点餐服务可用状态, 1-服务可用、0-服务不可用 order: 到店点餐服务可用状态：1-服务可用、0-服务不可用

示例值:

{"order_biz_mode":"REGULAR","order":"1","pre_order":"1"}

is_show

string

可选

门店是否在客户端显示，T表示显示，F表示隐藏

示例值:

latitude

string

可选

纬度，只有在query_type=KB_PROMOTER非空

示例值:

31.226948

longitude

string

可选

经度，只有在query_type=KB_PROMOTER非空

示例值:

121.549728

main_image

string

门店首图

可选

示例值:

AM-uJRh2SRKz9N0r9zW4wQAAACMAAQEC

main_shop_name

string

主门店名

可选

示例值:

海底捞

per_pay

string

可选

人均价格。单位是分。例如：2000，表示20元

示例值:

100

pic_coll

string

可选

图片集，是map转化成的json串，key是图片id,value是图片url

示例值:

{"IUFIDASFIEUIOFKSFIUFE83IEI":"http://object.alipay.com/getpic.do?kjkdjkjj"}

province_code

string

可选

省份编码，国标码，详见国家统计局数据点此下载

示例值:

110000

shop_id

string

门店ID

可选

示例值:

2015052100077000000000120773

shop_type

string

可选

COMMON（普通门店）、MALL（商圈）

示例值:

COMMON

status

string

可选

门店状态，OPEN：营业中、PAUSE：暂停营业、FREEZE：已冻结、CLOSE:门店已关闭

示例值:

OPEN

gmt_create

string

创建时间

可选

示例值:

{}

total_items

string

总记录数

可选

示例值:

total_page_no

string

总页码数目

可选

示例值:

🔴500请求失败