如何验证 OpenAPI 规范并生成 C# Rest API 客户端？答案

【问题标题】：How to validate the OpenAPI spec and generate C# Rest API Client?如何验证 OpenAPI 规范并生成 C# Rest API 客户端？
【发布时间】：2022-06-15 11:15:11
【问题描述】：

我正在尝试使用在 Atlassian site 上发布的 OpenAPI 规范为 Jira 云生成一个 Rest API 客户端。

我尝试过使用 Swagger Codegen、Openapi-generator 和 NSwag Studio。没有编译自动生成的 Rest API 客户端。我尝试为 .Net 4.X 和 .Net 6 生成，但没有任何效果。

请告诉我如何验证 OpenAPI 规范是否导致问题。如果这是导致问题的原因，是否有修复该 OpenAPI 规范并生成 Rest API 客户端的选项？我不想对自动生成的代码进行任何更改。

谢谢

【问题讨论】：

我将规范粘贴到 editor.swagger.io 并显示 2 个错误：路径上的语义错误。/rest/api/2/issue/properties/{propertyKey}.delete.requestBody DELETE 操作不能有请求体。路径中的语义错误。/rest/api/2/webhook.delete.requestBody DELETE 操作不能有 requestBody。
谢谢，我将删除该特定部分并尝试一下。

标签： c# swagger openapi swagger-codegen openapi-generator

【解决方案1】：

我可以使用 OpenAPI Generator 6.0.0 生成 C# 客户端并毫无问题地编译它：

openapi-generator-cli generate -g csharp-netcore -i https://developer.atlassian.com/cloud/jira/platform/swagger.v3.json -o /tmp/jira-csharp/

（openapi-generator-cli可以通过npm安装）

【讨论】：