servicestack ServiceStack SwiggerUI路由位置

各国的文件 默认配置要求ServiceStack服务在“/api”路径下可用 但我有我的api在根。有没有办法改变swagger ui的外观?我发现/swagger ui/index.html包含包含api位置的JavaScript代码 window.swaggerUi = new SwaggerUi({ discoveryUrl:'../api/resources', apiKey:"", dom_id:"

servicestack 带有招摇器的服务堆栈通配符路径

我正在使用ServiceStack,其路由如下: [Route("/hello/{Name*}")] 所以像/hello/some/parameters这样的事情都应该处理。 Swagger使用以下url:/hello/{Name*},无论我为Name参数提供了什么值,当我点击“试用”按钮时,我都会收到以下消息: 潜在危险的客户端值请求。从客户端(*)检索到的路径 注意,我使用的是以下ApiMember属性: [ApiMember(Name=“Params”,DataType=“string”

Swagger 2.0在何处声明基本身份验证模式

如何使用Swagger 2.0注释定义基本身份验证,并将其显示在Swagger UI中 在我的资源中: @ApiOperation(value = "Return list of categories", response=Category.class, responseContainer="List", httpMethod="GET", authorizations = {@Authorization(value="basicAuth")}) public Response getCateg

如何将自定义json转换为swagger 2.0 json

我不熟悉招摇过市的文档。我们有一个为RESTfulWeb服务开发的现有项目正在进行中。不同的基于资源的URL以application/json格式使用和生成。我们的一个资源url的输入和输出json格式如下所示: 请求: 答复: 如何将上述请求和响应json格式转换为swagger 2.0 json格式 谢谢 尝试使用。 此工具支持在流行格式之间转换API描述。 Supported formats: * swagger_1 * swagger_2 * api_blue

Swagger Azure API管理中的模型架构支持

在Swagger UI中,模型/模型模式记录在参数部分。当我将相同的文档导入Azure API管理门户时,会记录具有.NET数据类型的参数,但请求正文中的复杂对象/模型/模型架构会丢失其文档 我看到了模型模式支持的更新 但当我在API门户中尝试它时,它没有起作用 有人知道如何将模型架构文档导入Azure API管理门户吗 此更新是否仅在新门户中可用?如果是这样的话,API管理在新门户中何时可用 注意:我使用的是Visual Studio 2013中Swashback中的Swagger 2.0文档

Swagger 如何使用OpenAPI规范定义混合类型参数

我遵循OpenAPI(swagger)规范来定义我的API端点。这是用于获取用户数据的端点定义的摘录: "paths": { "/users/{id}": { "parameters": [ { "name": "id", "in": "path", "description": "The user ID on which the operation will be executed.", "required

Swagger 这句话的意思是什么

方法、参数和模型描述紧密集成到服务器代码中,从而在API及其文档中保持同步 这是否意味着,如果我对服务器代码进行任何更改,那么我也必须对yml文件进行更改?如果是,那么让我们假设,如果我从我的服务器运行100个API(例如,如果使用cherrypy),并且如果我对服务器代码进行任何更改以保持yml代码和API文档同步,那么我是否需要修改所有100个API的yml代码 基本上,我想知道如何处理服务器代码中的任何更改?是通过修改yml文件还是通过其他方式?此报价的来源是什么@海伦。。这些是一些来源

Swagger 尝试使用包含数组的对象参数时出现的虚张声势ui问题

好像快到了 试图让swagger在请求正文中发送匿名散列参数 我有一个匿名散列,其中包含一个名为list的键,该键包含一个数组 正在尝试发送此参数(text/json): Swagger正在构建正确的curl语句,但没有通过UI发送参数 Swagger构建了这个(从命令行工作): 但是Swagger ui没有显示模型示例,也没有在请求正文中发送任何参数 在编辑器中,我看到列表显示为未定义 Schema ⇄ Comparison { list: ComparisonList undefine

Swagger 多部分POST请求中带有参数的招摇过市错误

我正在使用Swagger Editor来记录一个现有的API,内置于节点中,但它不断给我以下错误: 路径处的架构错误。/upload/Rate.post.parameters[0] 不完全是来自, 此错误出现在“我的代码”的3个位置: 路径./upload/Rate.post.parameters[0] 路径./upload/Rate.post.parameters[1] 路径./users/register.post.parameters[0] 我已经搜索了很多次,但是,例如,这个链接没有

Swagger 什么是';必需的';在OpenAPI中真正的意思是

给定以下OpenAPI定义,以下哪些对象是有效的。只有一个。或1。和2 Person: required: - id type: object properties: id: type: string {“id”:“} {“id”:null} {} 这归结为“required=true”是指“非空值”还是“属性必须存在”的问题 位于的JSON模式验证器表示2。无效,因为null不满足type:string约束。请注意,它不会抱怨,因为id为null,而是

如何添加对swagger导出的响应?

我正在使用Paw将api调用导出到一个swagger文档 正在正确生成“请求”,但没有生成“响应”。他们都说: 默认值没有为此操作提供响应描述 如何添加响应 我的文件示例: <!DOCTYPE html> <html> <head> <title>ReDoc</title> <!-- needed for adaptive design --> <meta charset="utf-8"/&

如何覆盖Swagger/OAS 3中模型的数据类型?

假设我有一个这样的模型: Film: properties: title: type: string duration: type: string actors: type: array items: $ref: '#/components/schemas/Person' 我有很多模型继承了它,并添加了一些额外的属性 但我也有一个模

Swagger 带有外部引用验证的OpenApi

来自Soap、XSDs和WSDLs领域,我试图找到一种方法来重用在使用OpenApi v3时定义的一些模式 目录结构: 地址:yaml openapi: 3.0.1 info: title: An include file to define an address version: 1.0.0 paths: {} components: schemas: Address: type: object properties: id:

使用.NET Core 3.0添加swagger时出现异常

我试图将swagger集成到ASP NET Core 3.0项目中,它在ConfigureServices方法中抛出异常: 我正在使用swashback.AspNetCore4.0.1 我也检查了这个,还有 例外情况 System.AggregateException HResult=0x80131500 Message=Some services are not able to be constructed (Error while validating the service des

在环回中的swagger中隐藏一些请求参数/查询参数和响应模式字段

我们需要在swagger中隐藏一些请求参数/查询参数和响应模式字段。我们尝试了一些选择,但没有按预期效果。根据文档,我们无法在环回中实现此功能。有人对此有什么想法吗?在环回4中,您可以实现一个自定义OpenAPI规范增强器,该增强器将从服务器生成的API规范中编辑(隐藏)请求参数和模式字段-请参阅 我们在环回3中不提供此类功能。如果您正在通过API Explorer访问生成的Swagger规范,则可以分叉模块并添加代码以自定义生成的架构-请参阅中的函数mountSwagger

Swagger-pathToRegexp.parse不是函数或其返回值不可编辑

从配置Swagger UI时 一切正常,当添加以下行时,它抛出了一个错误 之前,我们曾尝试使用swagger ui express, 试图删除swagger ui express并安装fastify swagger /** * This is not a production server yet! * This is only a minimal backend to get started. */ import { Logger } from '@nestjs/common'; im

Swagger UI/IdentityServer 4:身份验证不处理加号字符

我已经在.NET5中使用Swagger UI和Identity Server 4设置了一个API。我使用客户端凭据流。一些API端点需要身份验证,而Swagger UI为此提供了授权表单。当我输入一个客户机id、作用域和一个客户机机密,但其中没有“+”字符时,这项功能正常工作: 但是,只要我使用一个包含加号的密码的客户端id,验证就会失败。当我使用C#编写的http客户端调用端点时,不会发生这种情况。因此,这一定是一个问题,如何招摇过市用户界面处理加号字符 我调查了这个问题,似乎Identit

如何在swagger 2.0中声明集合资源模型?

我不确定如何在swagger上为集合资源声明模型 缺少一些示例,所以我猜是这样的: Class: required: - id - name properties: id: type: string name: type: string ClassList: type: array items: type: schema: $r

如何在Swagger 2.0中引用顶级参数

我试图找出如何使用顶级参数,然后在操作级别,使用$ref引用在顶级对象中声明的定义 下面是YAML的外观,但当我尝试此操作时,会显示一个空参数。有人知道这个的正确语法吗 swagger: '2.0' info: version: 0.1.0 title: Customer API parameters: index: name: index in: query description: Specifies the offset of the first ite

Swagger 具有键的对象数组处于招摇过市状态

我们得到了一个现有的web服务,我们试图使用Swagger来记录它。它似乎经常使用以下方法返回对象: schema: type: array items: $ref: '#/definitions/Tweets' 在此模型中,tweet的id位于Tweets定义中。我返回的输出格式如下: { "127":{ "name":"Foo" }, "110":{ "name":"Bar" } } 其中id是对象

Swagger GitHub API的JSON模式定义

github api是否有JSON模式或招摇过市的定义?有没有这样的好资源来定义其他广泛使用的API 我看过github文档,没有看到任何关于api代码定义的内容。如果没有官方版本,可能在某个地方有一个非官方版本。比利,请查看的目录并按Github进行筛选 这应该是一个很好的起点。对于你拥有的RAML来说。 它有GitHub APIBtw,GitHub还发布了具有更大灵活性的Graph QL。看见

Swagger 不同对象的招摇过市数组

例如,我需要以swagger yaml格式表示以下结构: "included": [ { "type": "people", "id": "42", "attributes": { "name": "John", "age": 80, "gender": "male" } } ] 对于单个对象,一切都很好: included: type: "array"

Swagger Hub`Try it out`返回类型错误:使用浏览器选项时无法获取本地主机

我正在尝试使用openapi:3.0.1格式测试我的API文档。当尝试从Swagger Hub文档执行端点时,我得到TypeError:Failed to fetch 显示的curl命令可以从终端正常运行: curl -X GET "http://localhost:3030/services" -H "accept: application/json; charset=UTF-8" 这个问题既适用于Safari浏览器,也适用于Chrome浏览器 我还根据以下代码片段为我的golang应用程序

在Jhipster中添加swagger组

在Jhipster默认设置中,招摇过市页面上有两个组。默认组和管理组。我想添加第三组,比如api2 以下是默认设置的选择框: 在这里进行管理: 刚刚在别处找到了一个指针。这是解决办法。将此类添加到配置中: package nl.tibi.config; import static io.github.jhipster.config.JHipsterConstants.SPRING_PROFILE_SWAGGER; import static springfox.documentation.b

Micronaut openAPI Swagger未生成视图 mn--版本 |Micronaut版本:1.3.0.M1 |JVM版本:13.0.1 My build.gradle附于此处: 格雷德尔先生 -------------------------------------- 插件{ id“net.ltgt.apt eclipse”版本“0.21” id“com.github.johnrengelman.shadow”版本“5.1.0” id“应用程序” } 版本“0.1” “你好,世界” 存储库{ mavenCentral() maven{url“https://jcenter.bintray.com" } } 配置{ ////对于仅用于开发的依赖项 仅限开发 } 依赖关系{ 注释处理器平台(“io.micronaut:micronaut bom:$micronaut版本”) 注释处理器“io.micronaut:micronaut注入java” 注释处理器“io.micronaut:micronaut验证” 注释处理器“io.micronaut.配置:micronaut openapi” 编译“io.swagger.core.v3:swagger注释” 实施平台(“io.micronaut:micronaut bom:$micronautVersion”) 实现“io.micronaut:micronaut注入” 实施“io.micronaut:micronaut验证” 实现“io.micronaut:micronaut运行时” 实现“javax.annotation:javax.annotation api” 实现“io.micronaut:micronaut http服务器网络” 实现“io.micronaut:micronaut http客户端” 仅限运行时“ch.qos.logback:logback classic:1.2.3” testAnnotationProcessor“io.micronaut:micronaut注入java” testAnnotationProcessor平台(“io.micronaut:micronaut bom:$micronaut版本”) 测试实施平台(“io.micronaut:micronaut bom:$micronaut版本”) 测试实现“org.junit.jupiter:junitjupiter api” 测试实施“io.micronaut.test:micronaut-test-junit5” testRuntimeOnly“org.junit.jupiter:junit-jupiter引擎” } test.classpath+=configurations.developmentOnly mainClassName=“hello.world.Application” //使用JUnit5平台 试验{ useJUnitPlatform() } tasks.withType(JavaCompile){ options.encoding=“UTF-8” options.compilerArgs.add(“-parameters”) options.fork=true options.forkOptions.jvmArgs任务:compileJava 警告:注释处理器org.gradle.api.internal.tasks.compile.processing.TimeTrackingProcessor的受支持源版本“RELEASE_11”小于-source“13” 注意:生成OpenAPI文档 注意:将OpenAPI YAML写入目标:file:///Users/vkandas/Documents/OneDrive%20-%20Walmart%20Inc/Workspace2/hello-world/build/classes/java/main/META-INF/swagger/hello-world-0.0.yml 警告:注释处理器org.gradle.api.internal.tasks.compile.processing.TimeTrackingProcessor的受支持源版本“RELEASE_11”小于-source“13” 警告:注释处理器org.gradle.api.internal.tasks.compile.processing.TimeTrackingProcessor的受支持源版本“RELEASE_11”小于-source“13” 注意:为9个类型元素创建bean类 3警告 >任务:compileTestJava 警告:注释处理器org.gradle.api.internal.tasks.compile.processing.TimeTrackingProcessor的受支持源版本“RELEASE_11”小于-source“13” 警告:注释处理器org.gradle.api.internal.tasks.compile.processing.TimeTrackingProcessor的受支持源版本“RELEASE_11”小于-source“13” 警告:注释处理器org.gradle.api.internal.tasks.compile.processing.TimeTrackingProcessor的受支持源版本“RELEASE_11”小于-source“13” 注意:为2个类型元素创建bean类 3警告 此版本中使用了不推荐的Gradle功能,使其与Gradle 7.0不兼容。 使用“--warning mode all”显示单个弃用警告。 看见https://docs.gradle.org/6.0.1/userguide/command_line_interface.html#sec:command_line_warnings 在11s中成功构建 12项可执行任务:12项已执行 问题: 不会生成swagger ui。此外,虽然生成了swagger的静态资源,但micronaut不会为其提供服务。 application.yml micronaut: 路由器: 静态资源: 昂首阔步: 路径:classpath:META-INF/swagger 映射:/swagger/** 大摇大摆的用户界面: 路径:类路径:META-INF/swagger/views/swagger用户界面 映射:/swagger用户界面/** 应用程序: 姓名:你好,世界 启动应用程序正常: 格拉德尔跑步 >任务:运行 OpenJDK 64位服务器VM警告:选项-Xverify:none和-noverify在JDK 13中已被弃用,并可能在将来的版本中删除。 00:46:57.637[主]信息io.micronaut.runtime.micronaut-启动在810ms内完成。服务器运行:http://localhost:8080 启动V8 000 启动V8 111 0 1. 2. 3. 75%执行[1m 26秒] >:运行

----------问题:--------- 为什么没有生成Swigger ui视图?看起来有一些冲突,但不确定它们是什么。我正在做一个简单的测试,看看如何生成Swigger ui。 请提供一些帮助。几个小时来一直在努力解决这个问题。看来您需要使用micronaut openai库的更高版本 将gradle文件中的依赖项更改为 gradle build > Task :compileJava warning: Supported source version 'RELEA

Swagger 复制大摇大摆的用户界面';s';网址';行为规范

使用swagger ui时,我能够提供一个“URL”参数。这将为每页呈现一个招摇过市规范,顶部有一个选择器。我想做同样的事情,但是使用'spec'参数-即传递swagger json而不是url(返回swagger json)。我曾尝试将“spec”定义为JSON数组,但它抱怨这不是一个有效的规范 有办法解决这个问题吗?或者,更一般地说,是一种将json swagger规范粘合在一起的方式,这种方式可以由swagger ui呈现

Swagger 从接口到OpenAPI模式定义

假设我有这个接口: export interface User { name: { firstName: string, lastName: string } } 是否有任何工具、脚本或VSCode扩展可以从接口生成OpenAPI模式定义?比如: User: { type: 'object', properties: { name: { type: 'object',

Swagger ApacheOlingo(JavaOData)招摇过市API框架集成

我在Tomcat中有一个webapp,它通过ApacheOlingo公开OData端点。我在网上搜索了一些关键词,如招摇过市、奥林戈、整合,但没有找到任何答案 有一些关于.NET OData大摇大摆集成的信息,但我对此不感兴趣 请注意,我感兴趣的是Olingo和Swagger集成,而不是Swaggersocket集成 有人知道斯威格是否支持Olingo集成吗 编辑:Swagger UI是否与Olingo集成无缝配合

Swagger 招摇过市:通用响应/有效负载对象,但每个API定义的数据不同?

表示具有消息、总元素、数据和状态等基本字段的通用响应/有效负载对象的最佳方式是什么?其中,每个API之间的可变性是数据元素。例如,一个API可以用于权限,因此数据元素将保存一个权限数组。但对于另一个API,它将包含不同的对象类型数组。我的主要目标是对有效负载对象进行重用,并定义实际数据的下一个“层” 我希望能够定义一种通用的数据类型,比如具有基本字段的“响应”,但我希望能够为每个API进一步定义该内容(包含权限或角色或其他内容的数据) 下面是一些JSON示例,介绍了我们尝试过的内容,但没有按照我

是";评论「;OpenAPI3.0规范或Swagger编辑器中的受保护字?

我目前正在使用Swagger编辑器(v3.1.9)和OpenAPI3规范编写API规范 我得到了一些特殊的行为,特别是我命名的模式组件Comment Comment: description: "A comment on an asset or submission" allOf: - $ref: "#/components/schemas/Message" type: object properties: parent: on

Swagger 用于队列和消息传递(如mqtt或sqs)的类似招摇过市的文档

有没有像swagger这样的解决方案来记录队列和mqtt或sqs之类的消息传递?请检查 GitHub回购: AsyncAPI是一项开源计划,旨在改善事件驱动体系结构(EDA)的当前状态。我们的长期目标是使使用EDA与使用RESTAPI一样简单。从文档到代码生成,从发现到事件管理。我们现在应用于RESTAPI的大多数过程也适用于我们的事件驱动/异步API 要实现这一点,第一步是创建一个规范,允许开发人员、架构师和产品经理定义异步API的接口。就像OpenAPI(fka-Swagger)对RESTA

Swagger 如何为每个HTTP状态代码提供单独的示例?

我在试图指示Dredd发出不同的请求以触发两种不同的场景时遇到了问题:代码201成功,代码400失败 我试图为每个HTTP状态代码设置一个单独的示例,但无法做到这一点。 我可以在requestBody中添加example部分,但随后它将在两个示例中使用-用于成功和失败 openapi: 3.0.2 info: description: Body example per HTTP code illustration version: 1.0.0 title: Profile

Swagger 在位置响应头中引用服务器URL

在服务器对象中,我定义了一个URL: servers: - url: https://localhost:8088/abc 在响应定义中,我要引用此服务器URL: /test-sub-url: post: requestBody: required: true content: application/json: schema: type: object properti

nestjs swagger默认apiproperty到当前日期

这是我的代码: @IsDate() @ApiProperty({ type: Number, }) updateTime: Date; 如何从文档中将默认值添加到当前日期 您可以将代码更改为以下内容: @蜂房地产({ 类型:数字, 默认值:new Date().now()//或其他内容。。。 })有一个名为UpdateDateColumn的单独注释,用于存储更新的日期时间 @IsOptional({ groups: [CREATE, UPDATE] }) @Up

Swagger 2.0-来自Swagger源的结果不一致

下面是大摇大摆的消息来源。当我运行swagger工具验证程序时,我没有收到任何错误。当我在编辑器中加载它时,我看到了输出,但它是不正确的-它显示了错误的类型和不完整的成员对象。尝试使用code generator cli java工具时,出现以下错误: 711[main]错误io.swagger.models.properties.PropertyBuilder-无null属性,null 712[main]WARN io.swagger.util.PropertyDeserializer-无来自

Swagger 招摇过市:如何表示类型为类型列表之一的属性?

我有一个对象,它的属性是一个对象,其类型将是类型列表中的一个。我的所有尝试都被Swagger Editor拒绝,错误如下: Data does not match any schemas from 'anyOf' Jump to line 43 Details Object code: "ANY_OF_MISSING" message: "Data does not match any schemas from 'anyOf'" path: Array [7] inner: Array [2]

Swagger 如何在招摇规范中接收动态响应

我想通过API从数据库中请求一个表。但是,我不知道表将有多少列,或者它将包含什么。我如何在招摇过市中指定这一点?这就是我想做的: paths: /reports/{id}: get: summary: Detailed results description: filler parameters: - name: id in: path description: filler

未生成Tomcat-Jersey-Swagger.Json

我想为使用Jersey开发的ReST服务生成Swagger API文档 我已经阅读了Swagger API文档,并按照文档进行了部署 但是当我访问URL()时,我得到了以下输出 上面的一个示例不包含我们开发的API 我尝试了文档中提到的各种选项,但结果是一样的 我已经在tomcat 7.0.68中部署了该应用程序 我的Java版本是7 我使用maven下载依赖JAR,并手动将JAR复制到/WEB-INF/lib目录 Maven脚本 My web.xml 我的API类 请让我知道当前设置中存在什么

Swagger 在yaml中重用或$ref requestTemplates

可以使用$ref重用模式定义。是否有类似的方法用于重用字符串值,如Amazon API网关扩展的requestTemplates 我尝试过这些方法,但都会产生错误,我对YAML不太熟悉 requestTemplates: $ref: "#/definitions/MappingTemplate" definitions: MappingTemplate: type: "object" properties: application/jso

超出了Swagger UI最大调用堆栈大小->;反向参考

从swagger ui调用my swagger.json时,我收到一个错误: 超过最大调用堆栈大小 我想是因为我有 Token的所有者类型为User User具有类型为Token 当使用在线版本的swagger编辑器时,它可以解析类型。如何配置swagger以正确解析类型 完整的swagger.json { "swagger": "2.0", "info": { "description": "Descr", "version": "1.0.0",

Swagger 招摇过市示例属性隐藏所有其他属性

我在写一个关于这个词的夸张定义。有一种选择,可以让多个大摇大摆的人分享模型。完成招摇过市后,可以选择下载已导入链接定义的已解析招摇过市 我的问题是,这个已解决的下载在模型中添加了一个示例节点,无论出于何种原因,当我们再次在编辑器中复制这个新的招摇过市时,它都会覆盖每个属性 假设我们有下列样品 -- 大摇大摆:2.0 信息: 说明: 版本:1.0.0 标题:标题 主持人:example.com 基本路径:/ 计划: -http 消耗: -应用程序/json 生产: -应用程序/json 路径: /

Swagger ServiceStack中的DTO作为数组

我正在尝试将Web API服务迁移到ServiceStack,对服务定义的更改最少(无),但在创建以数组作为主体参数的操作时遇到问题,如在Web API服务中: 但如果我使用DTO数组,如下图所示,该操作将从Swagger中消失: 从T列表继承的请求类应该执行您想要的操作 乙二醇 公共类补丁客户:列表 { } public class PatchCustomer : List<ApiCustomer> { }

从Lumen REST API生成Swagger API文档

我已经在lumen 5.5中创建了一个REST API。*现在我需要为它创建一个swagger API文档,但我不想为每个API编写注释 任何解决方案除了编写多个注释(使用swagger php),您还可以编写一个包含所有api调用的yaml(或json)文件。是否有任何方法我不需要像在laravel中那样在注释中编写任何内容?我想是这样的

Swagger 大摇大摆的UI可以做多少修改

我有一些关于大摇大摆用户界面的问题。我从下载了swagger用户界面,并尝试修改index.html。据我所知,UI是基于开放api规范文档以yaml或json文件格式动态生成的。我的问题如下 有多少修改可以做的用户界面,正在生成的招摇过市 是否可以修改“试用”功能以获得更多控制?我想做的是有几个不是由swagger生成的输入字段,并将它们用作api调用的输入,使UI在本质上更具动态性 Swagger UI是否依赖于任何类型的API网关来调用API端点 谢谢 当一个“问题”中包含多个问题时,Sa

Swagger 如何为招摇过市的车型设定版本?

我有一个域模型,它包含许多类的东西,比如苹果、桔子和柠檬。例如,仅显示苹果: # version 1 Apple: type: object required: - id - name properties: id: type: integer name: type: string 稍后,我想在Apple中添加一个字段: # version 2 Apple: type: object required: -

  1    2   3   4   5   6  ... 下一页 最后一页 共 15 页