Visualizador OpenAPI / Swagger

Renderize um documento OpenAPI 3.0 / 3.1 ou Swagger 2.0 (YAML ou JSON) numa referência de API navegável — informação, servidores, caminhos agrupados por etiqueta, parâmetros, exemplos de corpo de pedido gerados a partir dos esquemas, respostas e segurança. Expanda qualquer operação para Experimentar e envie um pedido real a partir do seu navegador, ou exporte-a como cURL. Os documentos são analisados localmente; os alvos remotos de $ref e os esquemas externos não são obtidos (totalmente local). Prefere um compositor de pedidos interativo? Veja o Cliente / testador de API REST e toda a família Ferramentas de API.
Documento OpenAPI / Swagger
Experimentar
Parâmetros
Sobre este visualizador: suporta Swagger 2.0 e OpenAPI 3.0 / 3.1. As referências são resolvidas apenas dentro do documento (#/components/schemas/…, #/definitions/…); as referências a ficheiros ou URLs externos são indicadas em vez de serem obtidas. As chamadas Experimentar estão sujeitas à política CORS do servidor de destino — se uma chamada for bloqueada, use o Conversor de cURL ou o Cliente REST para a executar fora do sandbox do navegador.
OpenAPI vs Swagger, v2 vs v3

O Swagger foi o nome original da ferramenta; quando o formato da especificação foi doado à Linux Foundation em 2015, passou a chamar-se OpenAPI, e o Swagger sobrevive como marca de ferramentas. Um documento é construído a partir de info (metadados), paths (operações por endpoint) e components (esquemas reutilizáveis).

A chave de versão diz aos visualizadores qual o analisador a usar: swagger: "2.0" versus openapi: 3.0.x — a v3 passou os corpos de pedido para fora dos parâmetros e adotou o JSON Schema real.