用途:管理组织的 Platform API Token,即用于认证每次 ibl.ai API 调用的密钥。支持列出令牌、创建新 Api-Token(密钥仅显示一次)、按名称删除令牌。令牌以 platform_key 为作用域,而非 agent 作用域。
认证与约定:基础 URL 为 https://api.iblai.app;每个请求需带请求头 Authorization: Api-Token $IBLAI_API_KEY。路径变量 {org} = $IBLAI_ORG,{username} = $IBLAI_USERNAME。这些端点位于 …/dm/api/core/… 下。若尚未连接,先运行 /iblai-login 以填充 IBLAI_ORG、IBLAI_USERNAME 和 IBLAI_API_KEY。
读取:GET https://api.iblai.app/dm/api/core/platform/api-tokens/?platform_key={org} 列出 API 密钥。
写入:POST https://api.iblai.app/dm/api/core/platform/api-tokens/ 创建令牌,返回的密钥仅显示一次。请求体字段包括 username(必填)、name(必填)、key、platform_key(必填)、created(ISO 日期时间,必填)、expires(空字符串或秒数字符串,必填)、expires_in(秒数字符串,可选)。
删除:DELETE https://api.iblai.app/dm/api/core/platform/api-tokens/{name}?platform_key={org} 按名称删除密钥。此为破坏性操作,需先与用户确认。
示例:创建名为 prod-integration 的新 Platform API Token,并从响应中捕获密钥(仅显示一次): curl -X POST "https://api.iblai.app/dm/api/core/platform/api-tokens/" -H "Authorization: Api-Token $IBLAI_API_KEY" -H "Content-Type: application/json" -d '{"username": "'"$IBLAI_USERNAME"'", "name": "prod-integration", "key": "", "platform_key": "'"$IBLAI_ORG"'", "created": "2026-06-12T00:00:00Z", "expires": ""}'
注意事项:创建响应仅返回一次令牌密钥,须立即保存,之后无法再次获取。/iblai-login 使用同一个 POST …/platform/api-tokens/ 端点来生成并存储为 IBLAI_API_KEY 的 Api-Token。删除按令牌名称(而非 id)进行,并通过 platform_key={org} 限定到组织范围。