用途:当把项目分享给非工作区成员时,Spuree 不会直接添加对方,而是生成一条待处理邀请。本技能用于管理这些邀请。若目标已是工作区成员,则由项目管理的 POST /v1/projects/{projectId}/share 直接处理,不产生邀请。
主要能力:查看当前用户的待处理邀请(GET /v1/projects/invitations/pending);接受(POST /v1/projects/invitations/{token}/accept,接受后加入项目 sharedWith 列表,如非成员会自动加入工作区)或拒绝(POST /v1/projects/invitations/{token}/decline);列出某项目全部状态的邀请(GET /v1/projects/{projectId}/invitations,需所有者或共享用户);取消待处理邀请(DELETE /v1/projects/{projectId}/invitations/{invitationId},需项目所有者或原邀请人);重发邀请(POST /v1/projects/{projectId}/invitations/{invitationId}/resend,过期时间重置为 7 天,需所有者或共享用户)。
认证与地址:请求头 Authorization: Bearer $SPUREE_ACCESS_TOKEN,或 X-API-Key: $SPUREE_API_KEY。基址为 https://data.spuree.com/api/v1/projects。邀请状态有 pending、accepted、declined、expired,默认创建或重发后 7 天过期。
限制与错误:401 表示认证无效或过期;403 表示非授权用户;404 表示邀请不存在、已过期或已处理;409 表示该用户已有待处理邀请。部分细节暂未提供。