用途:该技能用于与 Apiary(协作式 API 设计与文档平台)交互,管理组织、用户、目标、过滤器等数据。涉及的 Apiary 对象包括 Apiary Object、Note、Attachment、Notebook、Template、Tag、User、Workspace。
主要能力:通过 Membrane CLI 与 Apiary 通信,Membrane 自动处理认证与凭证刷新。常见动作包括设置风格指南断言(set-styleguide-assertions)、获取风格指南断言(fetch-styleguide-assertions)、发布 API Blueprint(publish-api-blueprint)、获取 API Blueprint(get-api-blueprint)、列出 API(list-apis)。当内置动作不覆盖需求时,可通过 Membrane 代理直接向 Apiary API 发送请求。
使用方式:先安装 CLI:npm install -g @membranehq/cli;首次登录:membrane login --tenant。连接 Apiary:membrane search apiary --elementType=connector --json 获取 connector ID,再执行 membrane connect --connectorId=CONNECTOR_ID --json,用户在浏览器完成认证。可用 membrane connection list --json 查看已有连接;用 membrane action list --intent=QUERY --connectionId=CONNECTION_ID --json 搜索动作;用 membrane action run --connectionId=CONNECTION_ID ACTION_ID --json 运行动作,JSON 参数通过 --input 传入。代理请求示例:membrane request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。
适用场景:需要对 Apiary 中的 API 设计、文档、风格指南等资源进行集成和自动化操作的团队与开发者。
限制:官方文档地址为 https://developers.readme.com/。资料未提供更细的动作参数、定价、平台支持或效果说明,暂未提供。