Resultados da pesquisa a pedido "openapi"
Como referenciar exemplos de itens de matriz no OpenAPI 3?
Usando esta definição de esquema: schemas: AllContacts: type: array items: $ref: '#/definitions/ContactModel1' example: - id: 1 firstName: Sherlock lastName: Holmes - id: 2 firstName: John lastName: WatsonEu recebo este resultado esperado: [ { ...
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, ...
Como documentar nomes de parâmetros de consulta dinâmica no OpenAPI (Swagger)?
Existe alguma maneira de documentar a seguinte consulta? GET api/v1/users?name1=value1&name2=valueonde os nomes dos parâmetros de consulta são dinâmicos e serão recebidos do cliente. Estou usando a mais recente API do Swagger.
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 ...
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 ...
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: ...
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 ...
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 / ...
Como executar o swagger-codegen para o OpenAPI 3.0.0
parece oficial swagger [/questions/tagged/swagger] para openapi [/questions/tagged/openapi] o suporte à especificação V3 está próximo do lançamentohttps: ...
Página 2 do 2