用途:当组织开启申请模式时,用户不能直接加入,需填写组织配置的表单并提交,由工作人员审核决定,通过后授予成员资格。该技能覆盖申请人端(创建/续期草稿、保存答案、上传文件、缴费或豁免、提交、撤回)、审核端(流水线、逐学生决策、备注、豁免、费用管理、分班测试、课程分配、账号开通)以及表单管理(schema、配置、决策模板、续期窗口)。
主要能力:支持家庭形态,一名成人可代表一名或多名学生申请,每名学生生成独立候选人记录,各自有审核状态与决定。表单无学生区段时即为普通自申请。状态端点返回模式(open/application/invite_only)、表单列表、当前提交与费用状态。申请状态包括 draft、submitted、under_review、needs_more_info、interview_required、waitlisted、approved、denied、withdrawn;候选人状态包括 pending、under_review、needs_more_info、interview_required、waitlisted、accepted、declined。
使用方式:基础 URL 为 https://api.iblai.app/dm,路径前缀 /api/catalog/applications/...。每个请求需带 Authorization: Api-Token $IBLAI_API_KEY,并通过 platform_key(=$IBLAI_ORG)或 platform_org 限定组织。先调用状态端点判断模式,再获取表单定义、创建草稿、保存答案、上传文件、缴费后提交。未连接时先运行 /iblai-api-login 填充 IBLAI_ORG、IBLAI_USERNAME、IBLAI_API_KEY。
限制:所有端点需认证,匿名返回 401;审核与表单管理端点额外校验管理员权限,不足返回 403。申请人端点仅操作自己的申请,他人 id 返回 404。仅审核流水线列表分页,其余列表返回 { "results": [...] }。业务错误返回 { "error": "<machine_code>" },提交校验失败返回 400 及 errors 数组,限流写入返回 429。费用未结清时提交返回 402 fee_required,草稿不会丢失。家庭仅在 draft 和 needs_more_info 状态可编辑,可在未决状态撤回。DELETE 等破坏性调用需先与用户确认。