用途:通过 ibl.ai 平台 API 管理组织内的用户邀请,包括查看邀请状态(已接受/待处理)以及发送邀请,适用于将用户邀请加入某个组织。
主要能力:读取邀请列表,支持分页与排序;发送单个邀请;按 CSV 行逐条批量发送邀请;可在邀请时通过 user_group 与 user_group_owner_email 将受邀者分配到用户组。
使用方式:基础地址为 https://api.iblai.app,每个请求需带请求头 Authorization: Api-Token $IBLAI_API_KEY。路径变量 {org} 对应 $IBLAI_ORG,{username} 对应 $IBLAI_USERNAME。若尚未连接,先运行 /iblai-login 以填充 IBLAI_ORG、IBLAI_USERNAME 和 IBLAI_API_KEY。
读取:GET …/invitations/platform/?platform_key={org}&page={n}&page_size=5&sort=-id,用于列出已接受或待处理的邀请。
写入:POST …/invitations/platform/ 发送邀请,批量时对每个 CSV 行调用一次。请求体字段包括 email、platform_key(必填)、redirect_to、source、active,以及来自 CSV 的 company_name、first_name、last_name、user_group、user_group_owner_email。
示例:向新用户发送单个邀请,并在其接受后重定向到组织: curl -X POST "https://api.iblai.app/dm/api/catalog/invitations/platform/" -H "Authorization: Api-Token $IBLAI_API_KEY" -H "Content-Type: application/json" -d '{"email":"newuser@example.com","platform_key":"'"$IBLAI_ORG"'","redirect_to":"https://login.iblai.app/me","source":"'"$IBLAI_USERNAME"'","active":true}'
限制与注意:发送邀请会向真实用户发送邮件,批量运行前应先与用户确认收件人列表。列表为分页结果,需用 page / page_size 翻页,sort=-id 可让最新邀请排在前面。CSV 专用字段来自批量 CSV 的列。其他细节暂未提供。