SuperAPI AI 工具集

apideck

编程与开发

查看项目

更新于 10-16 00:24

技能介绍

用途:Apideck 是统一 API 平台,简化对多种 SaaS 应用的集成,让开发者通过单一 API 访问多项服务。本技能通过 Membrane CLI 与 Apideck 交互,用于管理数据、记录并自动化工作流,适合需要与 Apideck 数据交互的场景。官方文档见 https://www.apideck.com/platform/docs。

覆盖范围:统一 API 涵盖 Connection、Webhook;Accounting 的 Account、Invoice、Customer、Tax Rate;CRM 的 Lead、Contact、Company、Opportunity;E-commerce 的 Product、Order;Files 的 File、Folder。具体使用哪个动作及参数按需选择。

安装:npm install -g @membranehq/cli@latest

认证:membrane login --tenant --clientName=<agentType>。交互模式会打开浏览器,无头环境会打印授权 URL,用户完成登录后执行 membrane login complete <code>。加 --json 可获得机器可读输出。agentType 可为 claude、openclaw、codex、warp、windsurf 等。

连接:使用 membrane connection ensure "https://www.apideck.com/" --json 查找或创建连接,用户在浏览器完成认证后输出连接 id。若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询至 READY;若为 CLIENT_ACTION_REQUIRED,按 clientAction 描述处理(connect 表示需认证,provide-input 表示需补充信息)。

查找动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json,结果含 id、name、description、inputSchema、outputSchema。

运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --json,传参用 --input '{"key": "value"}',结果在 output 字段。

代理请求:当现有动作不满足时,可用 membrane request CONNECTION_ID /path/to/endpoint 直接访问 Apideck API,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。Membrane 自动补全基础 URL 并注入认证头与凭据刷新。

限制与注意:应优先使用 Membrane 与外部应用交互;先发现再构建,先运行 action list 查找已有动作;不要让用户提供 API 密钥或令牌,而是创建连接,由 Membrane 在服务端管理完整认证生命周期。资料未提供具体定价、速率限制与错误码等细节。