swagger-ui相关内容

Swagger UI 示例数据

有没有办法大摇大摆地显示示例数据;模型,输入和输出、查询参数、标题等?我在注释文档中找不到与此相关的任何内容;https://github.com/swagger-api/swagger-core/wiki/Annotations-1.5.X 解决方案 如果您查看 wiki 中提到的某些注释的文档,您将看到它们的可选参数中有一个称为 example 或 examples.您可以使用此参数添 ..
发布时间:2021-09-01 20:20:52 其他开发

Swagger 查询参数模板

我有一个有点复杂的查询参数,我有自己的语法来生成该值.它有多个变量来生成一个完整的字符串值.假设参数的名称是具有行和列的索引,就像使这个值 20:30 index = { row: 20, col:30 }index2 = { 行: 20, col:30, chr: 15 } 现在我想把它做成 example.com?index=20:30example.com?index2=20:30:1 ..
发布时间:2021-09-01 20:20:46 其他开发

如何使用服务名称在 Kubernetes 集群中交流 Swagger UI 和 API?

我在 Pod 内的 Kubernetes 集群上的 Docker 容器内运行了一个 node.js API.Pod 连接到 LoadBalancer 类型的 Kubernetes 服务,因此我可以从外部连接到它,也可以从 Swagger UI 连接到它,方法是将 API IP 地址传递给作为同一 Kubernetes 集群上的另一个 Docker 容器运行的 Swagger UI http://: ..
发布时间:2021-09-01 20:20:18 其他开发

SwaggerUI 不会在 POST 正文参数中显示用于集合的模型架构

我在 2014 年 6 月下载了 SwaggerUI,因为我刚刚下载了 dist 文件夹,所以不太容易找到它的版本. 在这几个月里,我一直在使用 Swagger 来记录我正在用 Jersey 构建的 REST API,我发现 UI 没有在数据类型列中显示模型和模型架构,用于在我的情况下作为集合的主体参数一个列表,它只显示“数组"这个词. 这个问题似乎在新版本中解决了,但是我对代码进行了 ..
发布时间:2021-09-01 20:20:14 其他开发

Spring Fox Swagger UI 掩码密码

我有一个 Spring Fox Swagger UI,我在其中执行了许多操作,其中之一是发布到 Jira,它需要用户输入他们的用户名和密码. 这个问题是密码没有屏蔽. 公共响应实体createJiraIssue( @RequestParam(value = "jiraProject") @ApiParam(value = ParamConfig.PROJECT_DESC) String ..
发布时间:2021-09-01 20:20:11 Java开发

在 Swagger UI 中更改默认 API 规范 URL

我正在使用 Swagger Editor Docker 映像来定义我的 API 规范并生成一个 nodejs 服务器以作为存根 api 运行并为我的 API 规范提供文档. 我想知道是否可以将默认 URL 更改为我自己的 URL,以便在我打开页面时显示我的规范,以及我将如何执行此操作. 比如我想把默认地址改成http://localhost:8080/spec 解决方案 如果我 ..
发布时间:2021-09-01 20:20:08 其他开发

使用 Swagger 公开默认未公开的架构

Swagger 默认公开暴露的控制器(API 端点)使用的任何架构.如果控制器不使用架构(类),如何公开它? 例如,Swagger 显示以下架构: 但是,Song Schema(如下)需要公开.它没有公开,因为它没有被控制器(API 端点)使用. 使用系统;命名空间示例命名空间{公开课歌曲{[关键][必填]公共 int SongID { 获取;放;}[必需的]公共字符串 SongNa ..
发布时间:2021-09-01 20:20:02 C#/.NET

Swagger 2:在数组类型的查询参数中使用枚举引用

无法获得如何在数组参数中使用带有枚举值的字符串类型的引用.我可以在 items 键中进行引用并且它正在工作,但是 Swagger 产生错误:不是有效的参数定义 Web UI 生成界面,但它有 textarea 而不是我期望的多选框. 正确的做法是什么? 我的代码: 招摇:'2.0':路径:/测试:得到:参数:- 在:起源名称:状态描述:产地要求:假架构:类型:数组项目:$re ..
发布时间:2021-09-01 20:19:45 其他开发

swagger JSON 产生空值,它停止 UI

我正在使用 swaggerspring mvc -1.0.2 和 jackson-databind 2.6.3.为什么它产生空值.如何停止它?它停止 swagger UI.JSON {“参数类型":{"absoluteType": "数组"},"name": "文件","description": "将文件作为输入传递",“默认值": "",“必需":真的,“allowMultiple":假, ..
发布时间:2021-09-01 20:19:40 其他开发

如何使用 Swashbuckle 在生成的 Swagger 文件中生成全局参数?

目前有多种方法可以通过 Swashbuckle 向每条路径添加参数.可以找到一些这样的方式 这里. 假设我想向每个名为“api-version"的路径添加一个参数.那么这个参数就会出现在Swagger文件的每一个路径中. 我希望 Swashbuckle 生成单个全局参数.例如,而不是这个 {“招摇":“2.0",“路径":{“/某事":{“帖子":{“operationId":“so ..
发布时间:2021-09-01 20:19:19 C#/.NET

Swagger 和 json-rpc

我正在尝试将 Swagger-ui 用于由 php 编写的 json-rpc 服务器.我使用 Swagger-PHP 为 Swagger-ui 生成 json 投诉容器.所以,我对 Swagger 很陌生,我对这样的方法使用了注释: /*** @SWG\资源(* apiVersion="0.2",* swaggerVersion="0.8",* basePath="http://mydomain ..
发布时间:2021-09-01 20:19:13 其他开发

如何摆脱swagger中的错误-没有定义的后期操作.",“allowedMethods":[>“获取"] }

我正在使用以下代码运行 swagger 并在执行 POST 操作时出错.. 招摇:“2.0"信息:版本:“0.0.1"标题:Hello World App# 在开发期间,应该指向你的本地机器主机:本地主机:10010# basePath 为所有资源路径添加前缀基本路径:/#方案:# 提示:删除 http 以达到生产级- http- https# 客户端可以发送的正文格式(内容类型)消耗:- 应用 ..
发布时间:2021-09-01 20:18:59 前端开发

同一方法的两条路径

一直在尝试使用 Swagger 为我的 PHP Rest API 生成文档,使用 swagger-php. 它工作得非常好,不太确定我是否喜欢由于文档而有大量评论块,但这不是问题. 我有两条路径: /user/[POST]/用户/登录 [POST] 它们都在我的 PHP 代码中调用了相同的方法:login(). 有没有办法让我说/user/[POST] 只是/user/log ..
发布时间:2021-09-01 20:18:23 其他开发