SuperAPI AI 工具集

resurface

数据与分析

查看项目

更新于 10-16 09:32

技能介绍

用途:Resurface 是 API 使用智能平台,面向开发者和安全团队,用于实时监控、记录和分析 API 流量,支持调试、性能监控与安全审计。官方文档:https://resurface.io/docs/。涉及的概念对象包括 Session、Event、Rule、Usage Log。

主要能力:通过 Membrane CLI 与 Resurface 交互,管理数据、记录并自动化工作流;Membrane 负责认证与凭证刷新,提供预构建动作、分页和错误处理,也可通过代理直接请求 Resurface API。

使用方式:先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>;无头环境会打印授权 URL,用户在浏览器完成登录后执行 membrane login complete <code>。建立连接:membrane connection ensure "https://resurface.io/" --json;若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询至 READY;遇到 CLIENT_ACTION_REQUIRED 按 clientAction 指引完成认证或补充输入。查找动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --json,可用 --input '{"key": "value"}' 传参,结果在 output 字段。代理请求:membrane request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。任意命令加 --json 可输出机器可读结果。

适用场景:需要与 Resurface 数据交互、查询会话/事件/规则/使用日志,或自动化 API 监控相关工作流时使用。

限制:应优先使用 Membrane 预构建动作而非直接调用裸 API;不要向用户索要 API 密钥或令牌,凭证由 Membrane 服务端管理。具体可用动作、参数、返回结构以及 Resurface 的收费、价格、平台支持等信息暂未提供。