swagger相关内容

Nginx Docker 容器上的静态网页缺少 CSS

我正在尝试使用 Nginx 在 docker 容器上托管 Swagger UI. 当我通过 hostAddress.com 访问我的网页时,它会以纯文本形式返回网页并检查它告诉我它找不到任何 javascript 或 css 文件,尽管它们似乎存在于容器中,因为我已经 ssh 进入容器进行检查. 我的码头文件 来自 nginx复制 src/usr/share/nginx/html复制 ..
发布时间:2022-01-22 18:28:37 前端开发

有没有办法从预编译的 C# Azure Functions 中自动生成 Swagger 标签?

是否有人知道任何可用于注释预编译 C# Azure 函数的 .NET 属性,以便它可以自动生成 Swagger 标记?例如,我想在 Swagger 中自动生成“标签"条目: /api/v1/revision:得到:operationId:/api/v1/revision/get标签:- 系统产生:[]消耗:[]参数: []描述:获取 API 版本回复:“200":描述:成功操作安全:- apik ..
发布时间:2022-01-22 18:28:28 C#/.NET

如何告诉 Swagger 一个属性是一个 Map

我正在与 Jersey 开发一项宁静的服务.但是,我正在使用 Swagger 作为文档.我的模型具有地图类型的属性.Swagger 将这个属性显示为一个 Object(不是特定类型).那么如何告诉 Swagger 这个属性来自 Map 类型呢? 公共类模型{私有字符串名称;私有映射我的地图;公共模型(){极好的();}公共字符串 getName() {返回名称;}公共无效集合名称 ..
发布时间:2022-01-22 18:28:22 Java开发

是否有可用于可视化设计 Swagger REST API 并生成 Swagger Specification YAML 规范的工具?

现在每个人都在制作 REST 应用程序.到目前为止,我只使用 swagger 编辑器来生成这些文件. 有没有人知道是否有成熟的工具或 IDE 可以直观地设计 Swagger REST API,然后生成 Swagger Specification YAML 规范文件? 工具可以是商业的或开源的 解决方案 我正在使用 https://studio.restlet.com 为此. ..
发布时间:2022-01-22 18:28:06 其他开发

Swagger:不允许的其他属性:allOf

我正在尝试通过使用 allOf 来找出这种招摇的 API 继承的东西.这是我招摇的 yaml 文件. 招摇:'2.0'信息:标题:测试API版本:'1'基本路径:/api/v1方案:- https产生:- 应用程序/json路径:/用户:得到:摘要:用户集合标签:- 用户回复:200:描述:用户列表架构:$ref:“#/定义/用户"500:$ref: "#/responses/BadReques ..
发布时间:2022-01-22 18:27:57 其他开发

ServiceStack POST 空体的招摇

我在使用 Swagger 插件到 ServiceStack 时遇到了一些问题.我已经为我的服务配置了路由描述,但生成的 POST 不包含正文. 我的服务如下所示: //////定义您的 ServiceStack Web 服务请求(即请求 DTO).//////路由是在这里定义的,而不是在AppHost中定义的.[Api("按 ID 获 ..
发布时间:2022-01-22 18:27:51 其他开发

移动 Flask-Restplus Swagger API 文档

我正在尝试使用 flask-restplus 在 python 中构建一个宁静的 API.我想让 swagger 文档位于与普通“/"不同的位置. 我正在关注这里的文档并按照说明进行操作.我正在使用 python2.7.3 并有以下代码 ~/dev/test/app.py: 从烧瓶导入烧瓶从 flask.ext.restplus 导入 API,apidocapp = Flask(__nam ..
发布时间:2022-01-22 18:27:18 Python

SpringFox - 在 Swagger-ui 中隐藏调用端点时不需要的某些字段

我想知道是否有任何方法可以让 SpringFox 不显示在调用特定端点时不需要的某个实体的所有字段. 例如: 拥有以下实体: 公共类汽车{长身份证;字符串名称;内轮;字符串类型;布尔值 canFly;} 还有以下端点: @RequestMapping(method = RequestMethod.GET,产生 = MediaType.APPLICATION_JSON_VALUE) ..
发布时间:2022-01-22 18:27:01 Java开发

Swagger.NET MVC API 异常

我一直在寻找提供自动生成的 API 文档的不同选项,而 Swagger 似乎就在那里. 但是,当我第一次尝试这个时,我在启动时遇到异常. 运行 Visual Studio 2013. 创建新的 Web API 项目. 使用包管理器,运行: Install-Package Swagger.Net &安装-Packager Swagger.Net.UI 确保我们已启用 XML 文档 ..
发布时间:2022-01-22 18:26:35 C#/.NET

Swagger - 时间戳怪异的表示

我有 Spring Boot 控制器,为了方便 API 参考,我使用了 Swagger.关于时间戳的问题.为什么在生成的文档示例中如下所示: “时间戳":{“日期":0,“天":0,“小时":0,“分钟":0,“月":0,“纳米":0,“秒":0,“时间":0,“时区偏移":0,“年":0} 那么为什么 swagger 有这么奇怪的时间戳示例,而不仅仅是简单的数值,哪个标准描述了这种表 ..
发布时间:2022-01-22 18:26:15 其他开发

如何定义HashMap<String、List<Object>>swagger yml 中的属性?

我正在使用 swagger 在 Java 和 Type 脚本中生成类.我在使用对象列表作为值定义地图属性时遇到问题.我尝试定义如下: DataMap类型:对象附加属性:#type: array -- 这个配置不起作用.$ref: '#/定义/数据' 上面的yml定义在java中生成如下代码: 类 DataMap 扩展 HashMap;{} 如何配置 yml 以生成带有数据列表的密钥?类似 ..
发布时间:2022-01-22 18:26:08 Java开发

如何使用 OpenAPI (Swagger) 描述多部分响应?

我有一项服务可以创建包含以下内容的多部分文件: 表示图像缓冲区的数据字节数组 表示图像信息(坐标、格式等)的 JSON 是否可以使用 YAML 在 OpenAPI (Swagger) 定义中对此自定义响应进行建模? 解决方案 可以使用 OpenAPI 3.0 描述多部分响应,但不能使用 OpenAPI 2.0 (fka Swagger 2.0). openapi: 3.0. ..
发布时间:2022-01-22 18:25:51 其他开发

如何在整个 Swagger YAML 文档中重复使用我的 x-amazon-apigateway-integration 定义?

我目前正在使用 Swagger 定义具有许多端点的 API,并且这些端点中的每一个都对“x-amazon-apigateway-integration"键具有相同的定义.我想在文档中的某个地方定义它,并在整个过程中重复使用该定义. 要么我不明白定义应该如何定义,要么我没有将它放置在正确的位置或两者的混合.我尝试在“定义"中定义这个定义,并在它自己的键下定义一些别名.定义(删除关键信息)是: ..
发布时间:2022-01-22 18:25:43 其他开发

大摇大摆的划掉方法

我正在为我的 .NET Swagger Web API 服务使用 Swaschbuckle. 我查看了来自 http://petstore.swagger.io/#/pet 的示例 并且存在被划掉的 Action findByTags. 我想在我的 api 服务中划掉一个动作,但是当我使用过时的属性时,这个动作是不可见的. 知道如何处理这个问题吗? 解决方案 我的 Web ..
发布时间:2022-01-22 18:25:22 C#/.NET