更新 Portal
POST
/web/v1/workspaces/{workspaceId}/institutions/{institutionBizId}/portals/updateWEB更新现有的 Portal 条目。支持部分更新。
鉴权
需要有效的 JWT token。网关验证:enableJwtToken=true,enableTurnstile=false。
请求参数
路径参数
| Name | Type | Required | In | Description |
|---|---|---|---|---|
workspaceId | string | Yes | path | 工作空间业务 ID |
institutionBizId | string | Yes | path | 机构业务 ID |
请求体
InstitutionPortalUpdateRequest:
| Name | Type | Required | In | Description |
|---|---|---|---|---|
institutionPortalId | long | Yes | body | 要更新的 Portal 记录 ID |
domain | string | No | body | 新的 Portal 域名 URL(最多 255 个字符) |
remark | string | No | body | 新备注(最多 255 个字符) |
portalStatus | integer | No | body | 新的 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) |
4040 | Portal 未找到 |
说明
- 仅更新请求体中非 null 的字段。