Resultados da pesquisa a pedido "openapi"

4 a resposta

Framework REST do Django Swagger 2.0

Dificuldade em configurar a interface do usuário do Swagger Aqui estão os documentos muito explicativos: https://django-rest-swagger.readthedocs.io/en/latest/ [https://django-rest-swagger.readthedocs.io/en/latest/] As doutrinas YAML estão ...

3 a resposta

Como incluir subclasses na documentação da API Swagger / na especificação OpenAPI usando o Swashbuckle?

Eu tenho um projeto Asp.Net web API 5.2 em c # e gerando documentação com Swashbuckle. Eu tenho um modelo que contém herança, algo como ter uma propriedade Animal de uma classe abstrata Animal e classes Dog e Cat que derivam dela. O Swashbuckle ...

4 a resposta

Como definir parâmetros de consulta mutuamente exclusivos no Swagger (OpenAPI)?

Eu tenho uma série de parâmetros no Swagger assim "parameters": [ { "name": "username", "description": "Fetch username by username/email", "required": false, "type": "string", "paramType": "query" }, { "name": "site", "description": "Fetch ...

3 a resposta

Swagger / OpenAPI - use $ ref para passar um parâmetro definido reutilizável

Digamos que eu tenho um parâmetro comolimit. Este é usado em todo o lugar e é uma dor ter que alterá-lo em qualquer lugar, se eu precisar atualizá-lo: parameters: - name: limit in: query description: Limits the number of returned results ...

3 a resposta

No Swagger, como definir uma API que consome um arquivo junto com um parâmetro de esquema?

Estou tentando usar o Swagger para definir uma API que aceita um arquivo real e um objeto de esquema que descreve o conteúdo de um arquivo. Aqui está um trecho do Swagger YAML. No entanto, não será validado no Swagger Editor. /document: post: ...

1 a resposta

Usando `default` com parâmetros` required` para OpenAPI

odocumentação [https://swagger.io/docs/specification/describing-parameters/#common-mistakes-10] diz: Usandodefault comrequired parâmetros ou propriedades, por exemplo, com parâmetros de caminho. Isso não faz sentido - se um valor for necessário, ...

2 a resposta

O que 'obrigatório' no OpenAPI realmente significa

Dada a seguinte definição do OpenAPI, quais dos objetos abaixo são válidos. Apenas 1. ou 1. e 2.? Person: required: - id type: object properties: id: type: string {"id": ""}{"id": null}{}Isso se resume à questão de se "required = true" significa ...

2 a resposta

Substitua "host" e "basePath" no nível "/ {path}"

DECLARAÇÃO DE PROBLEMA: Por uma razão "estranha", todas as nossas operações de uma API têm um "host" diferente. Temos API como esta: operação 1: GET https: // host1: port1 / api / resourcesoperação 2: GET https: // host1: port2 / api / ...

1 a resposta

Para que serve o campo 'escopos' do objeto do esquema de segurança arrogante?

petstore_auth: type: oauth2 authorizationUrl: http://swagger.io/api/oauth/dialog flow: implicit scopes: write:pets: modify pets in your account read:pets: read your petsEste é um exemplo securityDefinitions dea especificação ...

1 a resposta

Como especificar várias causas 404 no OpenAPI (Swagger)?

Estou definindo um caminho para um recurso aninhado (conteúdo pertencente a uma entrega). Se o cliente obtiver um 404, pode ser porque o ID da entrega não foi encontrado ou a entrega não continha nenhum conteúdo do tipo especificado. Como ...