Resultados da pesquisa a pedido "swagger"
UI do Swagger é exibida, mas recebo um indicador de "ERRO"
Minha interface de usuário do swagger é exibida e está mostrando todas as minhas rotas. Tudo parece ótimo, exceto que há um grande indicador vermelho de ERRO no canto inferior direito. Quando clico, recebo: { "schemaValidationMessages":[ { ...
Como gerar exemplos JSON a partir da definição de modelo OpenAPI / Swagger?
Estou criando um fuzzer para uma API REST que possui uma definição OpenAPI (Swagger). Desejo testar todo o caminho disponível da definição OpenAPI, gerar dados para testar os servidores, analisar o código e o conteúdo das respostas e ...
Criando um modelo extensível usando o Swagger / OpenAPI
Na minha API, eu gostaria de ter um modelo simples para minha coleção e um modelo mais elaborado para meu recurso individual. Por exemplo: uma solicitação GET em/libraries deve retornar BaseLibrary: type: object properties: library_id: type: ...
Swagger UI Marcação em vários níveis
Eu apenas comecei a trabalhar no Swagger api 2.0 recentemente. Estou procurando algumas maneiras de organizar a documentação da API. Atualmente, estou usando a anotação @Api (tags = {"Heading1"}) para marcar cada API. Agora a ...
Swagger: parâmetros do caminho curinga
Eu tenho uma API que permite que qualquer caminho arbitrário seja passado, por exemplo, todos estes: /api/tags/api/tags/foo/api/tags/foo/bar/bazSão caminhos válidos. Tentei descrevê-lo da seguinte maneira: /tags{tag_path}: get: parameters: - ...
Propriedades adicionais não permitidas: swagger anulável
Estou usando o swagger 2.0 com node.js express 4.12.3 e mysql db. Eu criei o seguinte esquema - Country: type: "object" properties: id: type: "integer" readOnly: true description: "Country Id" country: type: "string" description: "Country ...
Receba mensagens de erro detalhadas do AWS API Gateway Request Validator
fundoEu tenho um API Gateway criado usando as definições do Swagger 2.0 comExtensões do API Gateway [http://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-swagger-extensions-gateway-responses.html] . Substituí as respostas ...
Adicionando seções de agrupamento aninhadas na interface do usuário para ações em um controlador
É possível ter subseções dentro de um agrupamento de ações? Atualmente, usamos diferenciação baseada em controlador para agrupar funções, mas estamos hospedando uma grande quantidade de controladores e poderia usar aninhamento adicional. Em ...
Como secar ao usar o Swagger UI e as anotações ApiResponses com pontos de extremidade Java Spring?
Eu gostoSwagger porque torna suas APIs muito fáceis de usar. eu usoSwagger anotações como @ApiParam@ApiResponse | @ApiResponses@ApiOperationOutrasNos terminais, consulte parâmetros, solicite parâmetros, solicite o corpo e assim por diante. Eu ...
Parâmetros do swagger na consulta e / ou no corpo
Nossa API possui pontos de extremidade que suportam parâmetros, tanto doquery e dobody ao mesmo tempo, mesclando esses dois conjuntos de parâmetros. Por exemplo: /foo?param1=value1 body: { param2=value2 }O conjunto de parâmetros ...