Resultados da pesquisa a pedido "openapi"

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 / ...

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 ...

1 a resposta

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.

1 a resposta

Como definir respostas diferentes para o mesmo código de status HTTP no OpenAPI (Swagger)?

Estou escrevendo uma especificação OpenAPI para uma API existente. Essa API retorna o status 200 para êxito e falha, mas com uma estrutura de resposta diferente. Por exemplo, na API de inscrição, se o usuário se inscreveu com êxito, a API envia ...

2 a resposta

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 ...

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 ...

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 ...

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 ...

1 a resposta

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: [ { ...

2 a resposta

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: ...