Validar documento OpenAPI

Escolha OpenAPI 3.0 ou 3.1 em JSON ou YAML e indique os ficheiros de referência que forneceu.

  • Funciona no navegador
  • Sem envio
  • Verifique antes de transferir

Escolha OpenAPI 3.0 ou 3.1 em JSON ou YAML e indique os ficheiros de referência que forneceu. Reveja as operações, os destinos locais e os diagnósticos estruturais e dos Schema Objects. Só é suportado o dialeto OAS fixo; os formatos são anotações, sem validação de instâncias de dados.

Método: OAS 3.0 (2024-10-18) / 3.1 (2025-09-15); $schema: OAS3.1 (2024-11-10)

Processamento local

Os dados ficam no processo local do navegador, sem pedidos, armazenamento nem telemetria de conteúdo. As cópias dos originais e as exportações reveladas por si podem conter segredos; guarde-as só no seu dispositivo.

Limites de recursos

Entrada total até 1 MiB; texto até 200.000 carateres (XML 100.000); profundidade 32 e 20.000 nós por documento; no máximo 1.000 linhas ou operações; saída até 2 MiB; prazo de 5 s para o processo local. Cancelar termina o processo. Estes limites da aplicação não garantem um teto para toda a memória do navegador.

Até 20 ficheiros de referência fornecidos; até 1000 referências e cadeias até 32. Os IDs de recursos aninhados são identificadores lógicos locais e nunca carregam nada da rede. Os destinos base e a sintaxe das referências dinâmicas são verificados; as ligações dinâmicas a instâncias não são avaliadas.

Origem
Perfil declarado
Ficheiros de referência fornecidos

Escolha o perfil e reveja os diagnósticos antes de usar o resultado guardado. Editar, repor ou sair cancela o trabalho e descarta a pré-visualização. Guarde as cópias dos originais à parte; nenhum ficheiro de origem é substituído.

Cópia original: 1048576 B / Inspecionar / gerar

Como inspecionar estes dados

  1. Origem

    Carregue o documento JSON ou YAML de raiz, escolha o dialeto OAS3.0/3.1 automático ou explícito e forneça ficheiros de referência locais com nome. Os nomes têm de corresponder aos caminhos relativos de $ref.

  2. Perfil declarado

    Use OAS3.1.0, o título em info Demo e a versão 1, paths {} e components.schemas.Name.$ref = ./models.json. Forneça o models.json com {"type":"string"} para resolver esse esquema.

  3. Rever e guardar

    Examine os diagnósticos nos caminhos do documento e o grafo de referências. Sem o models.json, a referência fica por resolver; forneça-o e execute de novo antes de guardar o relatório.

Perguntas sobre o perfil

O que significa este resultado?

As verificações dizem respeito à estrutura do documento e às regras suportadas para objetos de esquema. Não enviam pedidos à API nem validam respostas reais em relação ao contrato.

Como resolver entradas rejeitadas ou em falta?

Um ficheiro com nome em falta fica por resolver; os URL remotos nunca são obtidos. Corrija a ortografia, o formato e o dialeto; resolver uma referência não garante que o conteúdo seja válido.

Quais são os limites desta ferramenta?

Perfis OAS3.0/3.1 locais e finitos, e não todas as extensões nem o comportamento dinâmico de ligação de instâncias. O texto de origem e as referências permanecem neste dispositivo.