新版店铺查询

使用新版店铺列表接口查询店铺，支持全部店铺、最近打开、可用店铺、待绑定设备、平台筛选和关键词搜索。

基本信息

Path: /queryEnvV2

Method: POST

请求参数

参数	类型	必填	说明
method	string	是	固定传 queryEnvV2。3980 当前需要 body 中带此字段，否则可能走旧查询逻辑或返回“未知请求”。
pageNum	number	否	页码，默认 1。
pageSize	number	否	每页条数，默认 10，建议不超过 100。
storeStatus	number/string	否	店铺范围。0/all 全部，1/recent 最近打开，2/available 可用店铺，4/pendingBind/waitBind/unbind 待绑定设备。
type	number/string	否	与 storeStatus 等价，也可用于传店铺范围。建议文档主推 storeStatus。
platformType	number/string	否	当前 3980 实测有效的平台过滤字段。取 platform-hierarchy.json 中一级平台的 id。邮箱一级平台为 83。
storeName	string	否	店铺名称搜索关键字。为空字符串表示不按名称过滤。
select	string	否	搜索字段选择，常用 storeName。

重要说明

platformType 使用一级平台 ID，不是二级站点 ID。

例如：

补充说明

queryEnv 保持旧逻辑不变；需要新版筛选能力时使用 queryEnvV2。

返回的 envs 会统一格式化店铺基础信息，便于外壳直接消费。

请求示例

 

成功返回示例

返回字段

字段	类型	说明
response.code	number	200 表示成功。
response.total	number	符合条件的店铺总数。
response.page / response.pageSize	number	当前页码和每页条数。
response.envs	array	店铺列表。
response.envs[].storeId	number/string	店铺 ID。
response.envs[].storeName	string	店铺名称。
response.envs[].ipId	number/string	绑定设备或 IP ID。
response.envs[].storeStatus	number	店铺状态。
response.envs[].equipmentType	string	设备类型
...	string	其它无关字段可不进行解析

失败返回示例

{
  "method": "queryEnvV2",
  "status": "error",
  "code": "400",
  "msg": "单次最多可查询100条数据"
}