swagger相关内容

整个响应的声明在swagger-php中可以重复使用吗?

我希望有一种方法来声明对每个终结点都相同的一些响应;例如,如果您没有正确的令牌,每个终结点将输出401,如果您的路径开头没有有效的id,则可能有另一组终结点都将输出id。 因此,对于几乎每种方法,我发现自己复制粘贴的内容如下: * @OAResponse(response=401, description="If no token..."), * @OAResponse(respons ..
发布时间:2022-08-16 13:25:33 其他开发

Swagger&39;swagger.json&39;加载,但在AspNet项目中的swagger UI';{localhost}/swagger';上出现404错误

正在使用AspNetCore为IIS托管的Web应用程序设置SWAGGER。.json页面加载并且似乎可以很好地接触到所有API,但是当导航到{localhost}/swagger查看UI页面时,我收到了一个404错误。我在Startup.cs中有以下代码: //Configure Services services.AddMvc().SetCompatibilityVersi ..
发布时间:2022-07-17 11:05:27 C#/.NET

当我从开发的值更改ASPNETCORE_ENVIRONMENT的变量时,Swagger页面不起作用

我有一个基于.NET6的Web API。 此Web API在Azure应用程序服务上运行。Azure应用服务在Linux上运行。 我使用Open API(Swagger)进行测试和文档编制。 我创建了2个应用程序设置文件。(开发和阶段) 我将ASPNETCORE_ENVIRONMENT变量添加到Azure应用服务的配置中,如下所示。函数用于ASPNETCORE_环境的两个变量(开发和阶段) ..

这些OpenAPI 3路径是否有歧义?

这些OpenAPI 3路径是不明确的吗? /shops/{shopId}/pets/{petId} /shops/{shopId}/pets/_search 我想回答否但是,严格阅读规范,我无法决定,因为它们似乎不属于规范所做的3个陈述中的任何一个: 这两条路径都不是具体(规范中使用的术语) 路径似乎不符合具有相同层次结构但不同模板化名称的模板化路径条件(我不是很清楚):" ..
发布时间:2022-05-24 14:09:50 其他开发

在Swagger Open API 3.0中使用另一个参数时,如何指示一个参数是有条件的必填参数

我已经创建了一个REST风格的API,现在我正在定义Open API 3.0 JSON表示以使用此API。 当存在另一个参数时,我要求有条件地使用参数。所以我不能真正使用required: true或required: false,因为它需要是有条件的。我是否应该将其定义为required: false,然后在summary和/或description中说明在使用其他参数时它是必需的?或者有 ..
发布时间:2022-05-24 13:32:56 其他开发

Swagger OpenApi Spec 3.0-删除操作

我正在使用swagger Openapi规范3.0从我的界面生成swagger。我有一个Delete方法,它接受请求正文。但根据RFC7231,Delete不接受任何请求Body。Swagger-request body也是如此。但是我的API被设计成在删除操作中接受请求正文。在创建swagger以使删除操作接受请求正文时有什么解决方法吗?目前,我从Savagger生成中得到的错误是什么? ..
发布时间:2022-05-24 13:08:45 其他开发

使用OpenAPI Maven插件生成API文档

我正在尝试为从OpenAPI 3 YAML生成的Spring REST应用程序生成API文档终结点(例如/v3/api-docs)。 我注意到Maven plugin有一个generateApiDocumentation标志 我不太确定它是做什么的。 遗憾的是,SpringFox还不支持OpenAPI 3--而且,当我只想将初始的YAML公开为json时,使用基于反射的生成器似乎毫无意义。 ..
发布时间:2022-05-24 12:50:54 其他开发

如何为嵌套对象编写swagger文档

本文档准备好NodeJS Create API,如何为嵌套对象编写swagger文档。 下面是我的完整的夸张文档代码。但它不显示用户对象。帮助我解决此问题 @swagger /api/v1/employees/add: post: tags: - Employees summary: "Create a new employee" descriptio ..
发布时间:2022-04-16 20:31:59 其他开发

找不到SWAGGER RETURN 404请求

这是一个基于.NET Core 3.1的ASP.NET MVC应用程序,安装了Swashuckle.AspNetCore 6.1.4(最新版本)。当我尝试在/swagger/index.html加载Swagger用户界面时,得到的是404。看起来Swagger中间件并没有处理该请求,而是转向了静态文件中间件。令人气愤的是,这种方法过去工作得很好,但我不知道我最近所做的哪些更改会导致这个问题。 ..
发布时间:2022-04-16 20:30:13 C#/.NET