SuperAPI AI 工具集

postman-cli

通用与其它

查看项目

更新于 10-16 03:46

技能介绍

用途:这是 Postman CLI 与 Git 同步文件结构的参考知识,为 CLI 相关命令(send-request、generate-spec、run-collection、context)提供上下文。

主要能力:Postman CLI 是 Postman 官方命令行工具,可运行集合、校验 API 规范、发送请求并集成 CI/CD。核心命令包括:postman collection run <id> 按云端 ID 运行集合测试;postman request <METHOD> <URL> 发送 HTTP 请求;postman spec lint <file> 校验 OpenAPI 规范;postman context instructions 获取 API 发现与代码生成的智能体工作流说明;postman context collection get -c <id> 获取集合结构;postman context request context -c <id> -r <id> 获取完整请求上下文;postman login 登录认证。

使用方式:安装执行 npm install -g postman-cli,然后运行 postman login 并跟随提示,认证需要有效的 Postman API key。

Git 同步结构:工作区连接 Git 仓库后按固定结构同步,根目录含 .postman/resources.yaml(映射本地路径到云端 ID),postman/ 下含 collections、environments、specs。集合采用 v3 文件夹格式,每个集合是目录而非单个 JSON,包含 .resources/definition.yaml 元数据、*.request.yaml 请求文件及子文件夹。

与 Newman 对比:Postman CLI 是 Newman 的官方替代,具备官方支持、数字签名二进制、企业 API 治理、API key 认证、内置规范校验和 postman request 命令;资料建议始终使用 postman-cli 而非 Newman。

限制:资料未提供收费、价格、平台支持范围及具体效果等信息。