查询工作空间邀请列表

GET/web/v1/workspaces/{workspaceBizId}/invitations JWT

列出工作空间的所有邀请，支持按状态、被邀请人邮箱和创建时间范围筛选。

鉴权

Auth Chain: WEB Chain — 需要 Authorization: Bearer <jwt> 系统注入的请求头（前端无需处理）：X-PORTAL-ACCESS-CODE（Nginx）、X-Request-Id（Gateway）

请求参数

Name	Type	Required	In	Description
workspaceBizId	String	Required	path	工作空间业务 ID
statuses	Array<Integer>	Optional	query	按邀请状态代码筛选
inviteeEmail	String	Optional	query	按被邀请人邮箱地址筛选
createdAtFrom	String (ISO 8601)	Optional	query	筛选在此时间戳之后创建的邀请（ISO 8601 格式）
createdAtTo	String (ISO 8601)	Optional	query	筛选在此时间戳之前创建的邀请（ISO 8601 格式）

成功响应

状态码: 200 OK

返回邀请对象数组。

成功 200

{
  "version": "1.3.0",
  "timestamp": 1709337600000,
  "success": true,
  "code": "2000",
  "message": "SUCCESS",
  "data": [
    {
      "bizId": "inv_abc123def456",
      "workspaceBizId": "WS_INVITE_TEST_001",
      "workspaceName": "测试工作空间",
      "inviterBizId": "ACC_OWNER_001",
      "inviterName": "所有者用户",
      "inviteeEmail": "invitee@example.com",
      "inviteeAccountBizId": "ACC_INVITEE_001",
      "inviteeAccountName": null,
      "invitationStatus": {
        "value": 10011001,
        "name": "PENDING",
        "code": "PENDING"
      },
      "message": "欢迎加入我们的工作空间",
      "expiresAt": "2026-03-29T10:30:00Z",
      "acceptedAt": null,
      "createdAt": "2026-03-22T10:30:00Z",
      "canAccept": true
    }
  ]
}

响应项字段

字段	类型	说明
bizId	String	邀请唯一业务 ID
workspaceBizId	String	目标工作空间业务 ID
workspaceName	String	目标工作空间显示名称
inviterBizId	String	邀请人账户业务 ID
inviterName	String	邀请人显示名称
inviteeEmail	String	被邀请人邮箱地址
inviteeAccountBizId	String	被邀请人账户 ID（若已注册）
inviteeAccountName	String	被邀请人显示名称（可为空）
invitationStatus	Object	状态枚举：PENDING、ACCEPTED、CANCELLED、DECLINED、EXPIRED
message	String	邀请消息
expiresAt	String	ISO 8601 过期时间
acceptedAt	String	ISO 8601 接受时间（可为空）
createdAt	String	ISO 8601 创建时间
canAccept	Boolean	邀请是否仍可接受

错误响应

未授权 401

{
  "success": false,
  "code": "4010",
  "message": "Invalid or expired token"
}

说明

• 需要 workspace:invitation:read 权限。
• 所有筛选条件均为可选，可组合使用。
• 无匹配邀请时返回空数组 []。