Skip to content

获取机构

GET/web/v1/workspaces/{workspaceId}/institutions/{institutionBizId}WEB

通过业务 ID 获取指定机构的详细信息。

鉴权

需要有效的 JWT token。网关验证:enableJwtToken=trueenableTurnstile=false

请求参数

路径参数

NameTypeRequiredInDescription
workspaceIdstringYespath工作空间业务 ID
institutionBizIdstringYespath机构业务 ID

成功响应

成功200
{
  "code": "2000",
  "message": "SUCCESS",
  "data": {
    "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"
  }
}

错误响应

错误码描述
4010未授权(无效或缺少 JWT token)
4040机构未找到

说明

  • 返回机构的完整详情,包括额外配置(如有)。

内部文档