用途：本技能整理了 Truto API 的调用约定，供开发者在用户项目中按规范构造请求、发现可用路由并排查常见错误。
主要内容：基础 URL 为 https://api.truto.one，所有请求需在 Authorization 头携带 Bearer 令牌；令牌限定单个环境，需要 environment_id 的操作会自动绑定令牌所属环境。JSON 请求用 Content-Type: application/json，文件上传用 multipart/form-data，工作流还接受 application/yaml。
URL 模式分三类：统一 API 为 /unified/{model_name}/{resource_name}，支持 list、get、create、update、delete 及 POST /unified/{model}/{resource}/{method_name} 自定义方法；代理 API 为 /proxy/{resource}，透传集成工具的原生 API；自定义 API 为 /custom/{path}，路径转发到集成的自定义处理器。三类调用都必须带 integrated_account_id 查询参数。
能力发现：构造任何 URL 前应先请求能力端点确认路由存在，可选 GET /integration/{slug_or_id}/capabilities 或 GET /integrated-account/{integrated_account_id}/capabilities，支持 type、methods、resource、has_description 等查询参数，响应包含 proxy、unified、auth、ai_readiness、account 等字段；跳过此步骤是 LLM 生成请求返回 404 的常见原因。
分页：列表端点返回 { result, next_cursor, prev_cursor }，将 next_cursor 作为查询参数取下一页，为 null 表示无更多数据；管理端端点复用 next_cursor，但响应信封为 { result, next_cursor, limit }，无 prev_cursor，过滤参数采用 field[operator]=value 结构化语法。
幂等：统一与代理的创建、更新、自定义方法调用及 POST /batch-request 支持 Idempotency-Key 头；DELETE 与 /custom/* 调用不支持。
限制与边界：资源与方法名称因集成而异；文中未提供价格、配额、速率限制或具体计费说明。