用途:通过 ibl.ai 平台 API 管理组织内的用户邀请,包括查询邀请状态和发送邀请。
主要能力:列出邀请(已接受/待处理),支持分页与排序;发送单个邀请;按 CSV 行批量发送邀请(每行调用一次 POST);可在邀请时通过 user_group 与 user_group_owner_email 将受邀者分配到用户组。
使用方式:基础地址为 https://api.iblai.app,每个请求需带请求头 Authorization: Api-Token $IBLAI_API_KEY。路径变量 {org} 对应 $IBLAI_ORG,{username} 对应 $IBLAI_USERNAME。若尚未连接,先运行 /iblai-api-login 以填充 IBLAI_ORG、IBLAI_USERNAME 和 IBLAI_API_KEY。
读取:GET …/invitations/platform/?platform_key={org}&page={n}&page_size=5&sort=-id 列出邀请。
写入:POST …/invitations/platform/ 发送邀请,请求体包含 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 可让最新邀请排在最前。