新版店铺查询

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

基本信息

Path: /queryEnvV2

Method: POST

请求参数

参数	类型	必填	说明
pageNum	number	否	页码，默认 1。
pageSize	number	否	每页条数，默认 10，最大 100。
storeStatus / type	number/string	否	店铺范围。0/all 全部，1/recent 最近打开，2/available 可用店铺，4/pendingBind/waitBind/unbind 待绑定设备。
actualPlatform	string	否	平台名称，用于平台筛选，例如 Amazon。
platform	string	否	站点或平台值，例如 US。
platformType	number	否	平台类型。不传时会根据 actualPlatform 自动推断；都不传默认为 0。
keyword / name	string/array	否	搜索关键词。字符串支持逗号、分号、空格或换行分隔。
searchType	string	否	搜索类型，支持 global、storeName、deviceName、ipId、region、storeAccount。默认 global。
storeIds	number/string/array	否	指定店铺 ID 列表，会透传到查询条件。

补充说明

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

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

请求示例

{
  "method": "queryEnvV2",
  "pageNum": 1,
  "pageSize": 20,
  "storeStatus": "available",
  "actualPlatform": "Amazon",
  "platform": "US",
  "platformType": 1,
  "keyword": "test-store",
  "searchType": "storeName"
}

成功返回示例

{
  "method": "queryEnvV2",
  "response": {
    "code": 200,
    "msg": "success",
    "total": 1,
    "page": 1,
    "pageSize": 20,
    "pageTotal": 1,
    "envs": [
      {
        "id": 10001,
        "storeId": 10001,
        "name": "test-store",
        "storeName": "test-store",
        "platform": "US",
        "actualPlatform": "Amazon",
        "storeAccount": "seller@example.com",
        "ipId": 20001,
        "ipAddress": "127.0.0.1",
        "equipmentType": "cloud",
        "bindUserName": "张三",
        "tags": [],
        "storeStatus": 2,
        "sortBy": 0
      }
    ]
  }
}

返回字段

字段	类型	说明
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	店铺状态。

失败返回示例

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