swagger相关内容

Swagger-PHP 用于为 Swagger-UI 生成 JSON 文件

我正在尝试使用 Swagger-PHP 生成 JSON 文件，以便我可以将它与 Swagger-UI 一起用于自动文档. 我尝试了链接:- https://github.com/zircote/swagger-php 我还尝试使用 http://zircote.com/swagger-php/installation.html 但我运气不好，我无法实现它. 我能够正确安装作 ..
发布时间：2022-01-22 18:20:39 PHP

Swagger 漂亮的 HTML 代码在哪里?

只有 ugly HTML 页面可供下载(HTML、HTML2 和动态都很丑)，但网站，例如.已编辑 https://app.swaggerhub.com/apis/{user}/{project}/{version}(和许多其他人！)提供漂亮的 HTML 界面......如何下载这个漂亮的 HTML? 完整和自主的 HTML 代码(文件或文件的 zip). 我的 API 有一个良好且有 ..
发布时间：2022-01-22 18:20:29 前端开发

swagger 结合一些重复的注解

我使用 .useDefaultResponseMessages(false) 并在每个方法中 @ApiResponses(value = {@ApiResponse(code = 200, message = "Success", response = Order.class),@ApiResponse(code = 401, message = "Unauthorized"),@ApiResp ..
发布时间：2022-01-22 18:20:20 其他开发

使用 Django Rest Framework 对 OpenAPI 端点进行自定义分组

我有一个 Django 项目，我正在使用 Django REST 框架.我正在使用 drf-spectacular对于 OpenAPI 表示，但我认为我的问题与这个包无关，对我来说这似乎是一个更通用的 OpenAPI 的东西(但不是 100% 确定我是否正确). 假设我有这样的 URL 结构: urlpatterns = [路径('admin/'，admin.site.urls)，路径(' ..
发布时间：2022-01-22 18:20:08 其他开发

使用未在招摇中公开的 HTTP 内容的 API 文件上传

我在现有的 Web API 中实现了一个 swagger 接口.当前的 API 控制器公开了一个异步上传功能，该功能使用 Request.Content 异步传输图像.已使用的代码在 这篇文章. 我的 api 控制器: [HttpPost][路线(“foo/bar/upload")]公共异步任务上传(){if (!Request.Content. ..
发布时间：2022-01-22 18:19:39 C#/.NET

通过 Swagger/OpenAPI 为附加属性指定多种类型

我希望在 OpenAPI 中表示以下 JSON 对象: {“名称":“鲍勃"，“年龄":4，...} 属性的数量和属性名称没有完全预先确定，所以我希望使用附加属性.但是，我不太确定它将如何通过 OpenAPI/Swagger 2.0 表示.我试过这个: 人员:类型:对象附加属性:类型:- 整数- 细绳 或等效的 JSON: {“人": {“类型":“对象"，“附加属性":{“类型":[“ ..
发布时间：2022-01-22 18:19:23 其他开发

单元测试招摇输出

我在 ASP.NET MVC WebAPI 项目中使用 Swagger.该项目安装了 Swashbuckle nugget 包并生成 Swagger UI 和 Swagger/docs/v1.我遇到的一个始终如一的问题是开发人员会通过不仔细命名他们的 webAPI 操作来破坏 swagger 文件.我想添加一个单元测试，以防止我通过在部署后转到 Swagger UI 站点并看到在 swagger ..
发布时间：2022-01-22 18:19:04 其他开发

使用 swagger 或任何其他工具生成 Rest API 文档

我正在寻找一种方法来记录我的 Rest API.我的服务器是 Tomcat/Spring 服务器，其余 API 使用 Jenkins 实现. Swagger 似乎是一个非常酷的解决方案，但我不知道如何在我的代码中使用它.我正在寻找创建 json swagger-ui 可以读取的最佳方法 - 我应该怎么做? 另外，我很乐意检查在这种环境中记录 Rest API 的任何其他好的解决方案. ..
发布时间：2022-01-22 18:18:57 Java开发

使用 Springfox-Swagger2 在 Swagger UI 中自定义请求标头描述

我在我的 Spring Boot 应用程序中使用 Springfox Swagger2 2.4.0 版、Springfox Swagger UI 2.4.0 版和 Swagger Annotations 1.5.0 版. 这里的问题是，我能够为我的控制器的 API 生成 swagger UI，并且我能够对其进行测试.但我无法为我的请求标头指定请求标头描述.我正在使用 @RequestHead ..
发布时间：2022-01-22 18:18:41 其他开发

文档 HAL“_links"来自 Spring Hateoas(大摇大摆)?

我想为我的客户开发团队记录一个 REST 服务. 所以我将 Spring-Hateoas 中的一些 Links 添加到我的资源 API，并将其插入 swagger-springmvc @Api... 注释来记录所有内容并为我的 Angular 团队提供良好的 API 参考，以便能够理解我的 REST 服务. 问题是 swagger 无法发现哪些链接是可能的，只是给我一大堆 Links ..
发布时间：2022-01-22 18:18:15 其他开发

从 typescript 接口生成 swagger 文档

我正在使用 swager-jsdoc 来记录应用程序的所有 DTO. 我想知道有没有办法从 typescript 接口自动生成 swagger 文档. 我在项目中有很多，还有很多猫鼬模式和模型.让它们保持同步变得越来越乏味.另一方面，我不想使用 swagger 生成工具.我更喜欢自下而上的方法. 干杯 解决方案 tsoa 的另一个选项是 路由控制器 + 路由-控制器-op ..
发布时间：2022-01-22 18:18:05 其他开发

如何在 Swagger open api 3.0 中定义常量字符串

swagger open api 3.0 中如何定义常量字符串变量?如果我定义枚举，它将如下所示 “状态码":{"title": "状态码",“枚举":[“成功"，“失败"],“类型":“字符串"} 但是枚举可以是值列表，有没有办法在swagger open api 3.0中定义字符串常量 代码可以从 http://editor.swagger.io/ 执行 解决方案 正如@Hel ..
发布时间：2022-01-22 18:17:56 其他开发