用途:把准备好的 overlay 文件应用到 OpenAPI 规范,生成被转换后的规范。输入需要源 OpenAPI 规范(-s)和 overlay 文件(-o),输出为修改后的规范(--out)。
命令:speakeasy overlay apply -s <spec-path> -o <overlay-path> --out <output-path>
示例:speakeasy overlay apply -s openapi.yaml -o my-overlay.yaml --out openapi-modified.yaml
推荐用法:将 overlay 写入 workflow.yaml,在 sources 下为 API 添加 overlays 列表;多个 overlay 按顺序应用,后一个可覆盖前一个。
排错:目标缺失通常是 JSONPath 不匹配,需核对路径大小写;报无效 overlay 通常是 YAML 结构有误;未应用改动多为目标路径错误,可使用 $.paths['/exact-path'] 语法。
相关技能:create-openapi-overlay、regenerate-sdk、fix-validation-errors-with-overlays。资料未提供安装方式、价格与平台信息。