接受工作空间邀请

POST/web/v1/system/profile/invitations/{invitationBizId}/accept JWT

接受已认证用户的工作空间邀请。用户将被添加为该工作空间的成员。

鉴权

Auth Chain: WEB Chain — 需要 Authorization: Bearer <jwt> 以下请求头由系统自动注入（前端无需处理）： X-PORTAL-ACCESS-CODE (Nginx), X-Request-Id (Gateway)

请求参数

Name	Type	Required	In	Description
invitationBizId	String	Required	path	邀请业务 ID

无需请求体。

成功响应

成功 200

{
  "success": true,
  "code": "2000",
  "message": "SUCCESS",
  "data": {
    "invitationBizId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "workspaceBizId": "WS_ACME_001",
    "becameDefaultWorkspace": false,
    "nextAction": {
      "code": "ENTER_ACCEPTED_WORKSPACE",
      "value": 10050403,
      "label": "进入已接受的工作空间"
    }
  }
}

响应字段

字段	类型	描述
invitationBizId	string	已接受邀请的业务 ID
workspaceBizId	string	用户加入的工作空间
becameDefaultWorkspace	boolean	该工作空间是否成为用户的默认空间
nextAction	object	推荐下一步动作枚举 {code, value, label}

下一步动作值

Code	Value	描述
ENTER_DEFAULT_WORKSPACE	10050401	用户已有默认工作空间
CHOOSE_WORKSPACE	10050402	用户有多个工作空间，应选择一个
ENTER_ACCEPTED_WORKSPACE	10050403	导航到刚接受的工作空间

错误响应

冲突 409

{
  "success": false,
  "code": "WORKSPACE.INVITATION_ALREADY_PROCESSED",
  "message": "Invitation has already been processed"
}

冲突 409

{
  "success": false,
  "code": "WORKSPACE.INVITATION_EXPIRED",
  "message": "Invitation has expired"
}

禁止访问 403

{
  "success": false,
  "code": "WORKSPACE.CROSS_PORTAL_ACCEPT",
  "message": "Cross-portal invitation acceptance is not allowed"
}

错误码	HTTP	描述
WORKSPACE.INVITATION_ALREADY_PROCESSED	409	邀请已被接受、拒绝或取消
WORKSPACE.INVITATION_EXPIRED	409	邀请已过期
WORKSPACE.CROSS_PORTAL_ACCEPT	403	被邀请人门户类型与工作空间门户类型不匹配

说明

• 接受邀请后，用户将被添加为工作空间成员。
• 邀请被消费后不可再次接受。
• 跨门户接受（如 CONSUMER 用户接受 TENANT 工作空间邀请）会被拒绝。