机构列表

POST/web/v1/workspaces/{workspaceId}/institutions/queryWEB

返回机构的分页列表，支持可选筛选条件。

鉴权

需要有效的 JWT token。网关校验：enableJwtToken=true，enableTurnstile=false。

请求参数

路径参数

Name	Type	Required	In	Description
workspaceId	string	Yes	path	工作区业务 ID

请求体

InstitutionQueryRequest：

Name	Type	Required	In	Description
institutionBizId	string	No	body	按机构业务 ID 筛选
institutionType	string	No	body	按机构类型筛选：SYSTEM、TENANT、PARTNER、CONSUMER
institutionStatus	string	No	body	按状态筛选：PENDING、REVIEWING、ACTIVE、REJECTED、SUSPENDED、CLOSED
institutionName	string	No	body	按机构名称筛选（模糊匹配）
page	integer	No	body	页码（从 0 开始，默认值：0）
size	integer	No	body	每页大小（1-100，默认值：20）

成功响应

成功200

{
  "code": "2000",
  "message": "SUCCESS",
  "data": {
    "institutions": [
      {
        "bizId": "inst_abc123",
        "institutionName": "Acme Corp",
        "institutionDescription": "Main institution",
        "institutionRemark": null,
        "institutionType": "TENANT",
        "institutionStatus": "ACTIVE",
        "extraConfig": null,
        "createdAt": "2026-03-21T00:00:00Z",
        "updatedAt": "2026-03-21T00:00:00Z"
      }
    ],
    "totalElements": 1,
    "totalPages": 1,
    "currentPage": 0,
    "pageSize": 20
  }
}

错误响应

错误码	描述
4000	校验错误（无效的 page/size 值）
4010	未授权（无效或缺少 JWT token）

说明

• 所有筛选字段均为可选；省略时返回所有机构。
• 租户 Portal 用户可能根据其权限看到筛选后的视图。