获取主访问码

GET/web/v1/workspaces/{workspaceId}/institutions/{institutionBizId}/portals/portal-types/{portalType}/access-code/primaryWEB

获取指定 Portal 类型的主（活跃）访问码。返回脱敏后的访问码。

鉴权

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

请求参数

路径参数

Name	Type	Required	In	Description
workspaceId	string	Yes	path	工作空间业务 ID
institutionBizId	string	Yes	path	机构业务 ID
portalType	integer	Yes	path	Portal 类型代码（例如：10010101=system、10010102=tenant）

成功响应

成功200

{
  "code": "2000",
  "message": "SUCCESS",
  "data": {
    "accessCode": "pac_****abcd",
    "institutionBizId": "inst_abc123",
    "portalType": 10010102,
    "expiresAt": "2026-06-21T00:00:00Z",
    "rotatingCode": null,
    "rotatingCodeExpiresAt": null
  }
}

错误响应

错误码	描述
4010	未授权（无效或缺少 JWT token）
4040	Portal 或主访问码未找到

说明

• 与通用访问码接口不同，此接口仅返回主（非轮转）访问码。