SuperAPI AI 工具集

devnet-meraki-search

编程与开发

查看项目

更新于 10-15 17:21

技能介绍

用途:帮助网络工程师快速检索 Cisco Meraki API 文档,覆盖防火墙规则、VLAN 管理、无线配置、OAuth 设置等自动化任务,无需手动浏览 DevNet。

主要能力:包含两个工具。Meraki-API-Doc-Search 按关键词搜索文档,参数 query(字符串,必填)为搜索词,limit(整数,可选)限定返回结果数量;返回 API 端点路径与 HTTP 方法、操作描述与摘要、参数详情与代码示例、分类标签。Meraki-API-OperationId-Search 按精确 operationId 查询特定操作,参数 operationId(字符串,必填);返回该操作的完整 OpenAPI 规范、全部参数模式(path、query、body)、请求与响应体模式,以及可用时的代码示例。

使用方式:常见流程为先用关键词搜索定位端点,用户选定某个操作后再用 operationId 查询完整规范;若已知 operationId,可直接查询。示例:搜索“L3 firewall rules”可返回 PUT/GET /networks/{networkId}/appliance/firewall/l3FirewallRules;搜索“VLAN management”可返回 /networks/{networkId}/appliance/vlans 的 GET、POST 及带 vlanId 的 PUT;搜索“wireless SSID configuration”可返回 /networks/{networkId}/wireless/ssids 的 GET 与 PUT;用 operationId “createNetworkMerakiAuthUser” 可查到 POST /networks/{networkId}/merakiAuthUsers 及其参数与请求体字段。

限制与错误处理:搜索无结果时建议使用更宽泛的搜索词、检查技术术语拼写或改用替代说法(如 firewall 与 ACL);operationId 无效时需确认大小写、先用文档搜索获取有效 ID,并确认该操作存在于当前 Meraki API 版本;DevNet 服务器不可达时检查网络连接、查看 https://devnet.cisco.com 状态并稍后重试。具体可用性、覆盖范围与版本细节暂未提供。