能否通过MS Kiota CLI使用文档填补OpenAPI规范的Schema缺口?
Kiota CLI是否支持补充OpenAPI文档合并到基础规范?
Kiota CLI原生支持将补充的OpenAPI增量文档与基础规范合并,无需自行开发合并工具,完美解决你提到的「不修改原始规范、单独维护增量内容」的需求:
- 核心用法:生成客户端代码时,通过
--additional-document(简写-a)参数指定你的增量补充文档,该参数可多次使用以添加多个文件。示例命令:kiota generate -d base-spec.json -a supplement-spec.json -l csharp -o ./generated-client - 补充文档要求:只需遵循OpenAPI规范结构,针对基础规范中缺失的部分做增量定义(比如补全响应Schema)即可,Kiota会自动将增量内容合并到基础规范中用于代码生成。
- 优势:原始基础规范和增量补充内容可分开存储、各自纳入版本控制,避免直接修改上游原始文档,大幅提升可维护性。
内容的提问来源于stack exchange,提问作者bmargulies
相关产品推荐
相关产品推荐

