用途:依据官方 OpenAPI 契约编写调用 Elaichi REST API(https://api.elaichi.ai)的代码。机器可读描述可直接未认证获取:GET https://api.elaichi.ai/openapi.json(另有 /openapi.yaml)、GET https://api.elaichi.ai/schema/openapi.json(另有 /schema/openapi.yml),并以其为契约;路径不带版本号,如 /connection。
认证与限制:请求头 Authorization: Bearer elch_{org_id}_{64 hex},令牌由个人在 app.elaichi.ai 的 Settings → API tokens 创建,需 api_token:create 权限并当场重新验证,原始值只显示一次。令牌无 scope,以创建者身份及其实时权限行事,绑定单一组织,不能管理令牌(/api-token 路由返回 403)。部分操作仅限浏览器会话(令牌 403),包括 /api-token、/scim-token、解决访问请求、安排组织删除、更改双因素要求、批准 AI 客户端、更改支付设置。令牌不会收到 428 step_up_required。
组织头与列表:X-Organization-Id 可选,若发送必须匹配;/organization/:id/* 从路径取组织。列表统一返回 result、next_cursor、prev_cursor;limit 默认 50、最大 200,cursor 不透明需原样回传,q 最多 200 字符,逐词匹配并可容忍一次拼写错误。仅在服务端搜索、过滤、排序、计数,变更 q 或过滤需丢弃游标;分页以 next_cursor 为 null 结束。
错误与能力:错误结构含 error.message、code、details,应原样展示 message,404 视为“非你所有”。can_use、can_share、can_manage、can_transfer 等能力字段由服务端计算,应直接读取,另参考 access_via、restricted。REST 限 600 请求/60 秒,MCP 限 120 请求/60 秒,超限返回 429 与 Retry-After;公开 API 无幂等键。ID 为 {prefix}_{26 字符} 的 TypeID,连接器用 slug 命名;global:{userId} 与 connection:{connectionId} 自动工具箱只读。其余细节见 Endpoints、Patterns 及配套技能。