Skip to content

更新 Portal

POST/web/v1/workspaces/{workspaceId}/institutions/{institutionBizId}/portals/updateWEB

更新现有的 Portal 条目。支持部分更新。

鉴权

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

请求参数

路径参数

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

请求体

InstitutionPortalUpdateRequest:

NameTypeRequiredInDescription
institutionPortalIdlongYesbody要更新的 Portal 记录 ID
domainstringNobody新的 Portal 域名 URL(最多 255 个字符)
remarkstringNobody新备注(最多 255 个字符)
portalStatusintegerNobody新的 Portal 状态码

成功响应

成功200
{
  "code": "2000",
  "message": "SUCCESS",
  "data": {
    "id": 1,
    "institutionBizId": "inst_abc123",
    "portalType": 10010102,
    "domain": "https://new-tenant.example.com",
    "portalStatus": 10080101,
    "remark": "Updated remark",
    "createdAt": "2026-03-21T00:00:00Z",
    "updatedAt": "2026-03-21T01:00:00Z"
  }
}

错误响应

错误码描述
4000验证错误(缺少 institutionPortalId)
4010未授权(无效或缺少 JWT token)
4040Portal 未找到

说明

  • 仅更新请求体中非 null 的字段。

内部文档