"Download remote OpenAPI JSON to local file via aptx-ft. Use when user asks to fetch swagger/openapi from URL, save spec to openapi.json, or prepare local input for later model/service generation."
Resources
1Install
npx skillscat add haibaraaiaptx/frontend-openapi-skills/download-openapi Install via the SkillsCat registry.
SKILL.md
下载 OpenAPI JSON
使用底层命令,不包含本地脚本包装。
前置条件
在目标项目安装 aptx 包,并确保可执行 aptx-ft:
pnpm add -D @aptx/frontend-tk-cli执行步骤
- 选择输出文件路径(建议
./openapi.json)。 - 执行下载命令。
- 下载成功后,把该文件路径交给其他技能(如模型生成、请求框架生成)。
pnpm exec aptx-ft input download --url <url> --output <file>可选(未使用 pnpm 时):
npx aptx-ft input download --url <url> --output <file>示例:
pnpm exec aptx-ft input download --url https://api.example.com/swagger.json --output ./openapi.json输出
- 本地 OpenAPI JSON 文件(例如
./openapi.json)。
边界
本 skill 仅处理 OpenAPI JSON 格式的下载:
- 不支持 YAML 格式的 OpenAPI 规范
- 不处理需要认证的 URL(如需要 Bearer Token)
- 不处理自定义请求头
- 下载后不自动验证 OpenAPI 规范的有效性(仅验证 JSON 语法)
如需上述功能,请手动下载后使用其他工具处理。