Ferramentas de API
Escolha uma operação e um corpo para usar um exemplo ou gerar pelo schema.
A especificação e os corpos ficam neste navegador; nenhuma requisição à API é enviada.
Lendo operações…
Dados mock OpenAPI ajudam a testar uma tela enquanto o endpoint ainda está sendo implementado. Cada fixture fica ligada à operação e ao status que a definem. Assim, um exemplo de sucesso não vira um teste de erro com campos que o contrato não permite.
Ao gerar dados mock a partir de schemas OpenAPI, a quantidade representa corpos completos. Se o próprio corpo for uma lista, seu tamanho continua sendo definido por items e pelos limites do schema, não pela quantidade do lote.
Dados mock OpenAPI podem representar um 400 ou 404 declarado com a mesma facilidade de um 200. Selecione o exemplo nomeado sem alterar a especificação. Cada exemplo pertence ao status e ao tipo de mídia escolhidos, sem misturar respostas de outras situações.
Desative a prioridade dos exemplos e fixe a semente para repetir a sequência com o mesmo documento e as mesmas opções. Guarde também a versão do motor. Um exemplo explícito ou uma constante pode continuar igual mesmo com outra semente.
O exemplo YAML inicial preenche as listas automaticamente. A direção de requisição trata apenas requestBody; a de resposta usa o status e a mídia selecionados. Parâmetros de caminho, consulta e cabeçalhos não entram nesse corpo.
O example da mídia e seus examples nomeados vêm antes dos exemplos do schema e das propriedades. Um exemplo inválido gera erro, sem troca silenciosa por um valor aleatório. Desative a prioridade quando quiser explorar os valores permitidos pelo schema.
Um resultado JSON mantém a forma original do corpo. Vários resultados recebem um array externo; JSONL coloca um corpo completo em cada linha. Ctrl/Cmd + Enter gera os dados. Qualquer alteração bloqueia a exportação até uma nova geração válida.
Encontre a operação por método e caminho e escolha um código, faixa de status ou default declarado. O padrão procura 200, depois outro 2xx e depois a primeira entrada. Uma resposta mock de erro segue o mesmo fluxo de uma resposta de sucesso.
Valores embutidos, exemplos nomeados e referências locais a Example Object são aceitos. Exemplos aplicáveis do schema e das propriedades também são usados. Cada corpo passa pela validação antes do download, mesmo quando já estava em examples.
Requisições excluem propriedades readOnly, e respostas excluem writeOnly. Os itens required correspondentes são ajustados. Se um exemplo fornecido trouxer um campo excluído, ele será rejeitado, sem remoção silenciosa antes de exportar.
Gere de 1 a 100 corpos independentes. uniqueItems exige unicidade no array dentro de cada corpo, não em todos os corpos do lote. Aumentar a quantidade não altera as restrições das listas definidas pelo contrato.
Cole o documento completo compatível e escolha operação, direção e mídia. Mantenha a prioridade para aproveitar os exemplos documentados ou desative-a para amostrar o schema. Um schema isolado pode ser usado no gerador dedicado a schemas.
Selecione primeiro o status e a mídia JSON e depois o exemplo nomeado naquele local. Valores embutidos e referências locais a Example Object são aceitos. O exemplo da mídia tem prioridade sobre o do schema.
Sim, se a operação declarar a resposta com um schema JSON suportado. Escolha 400 ou 404 para obter o corpo correspondente como fixture. A ferramenta não envia uma resposta HTTP nem simula uma falha real do servidor.
A semente padrão é 42. Com o mesmo documento e as mesmas opções, a amostragem se repete. example, const e enum com um só valor podem permanecer iguais para qualquer semente. Desative a prioridade dos exemplos antes de comparar sementes diferentes.
Não. A validação compara o corpo fornecido ou gerado com o schema efetivo suportado. Ela não acessa a API, não executa middleware e não verifica cabeçalhos reais, autenticação ou regras de negócio.
Qual outra restrição você precisa?
Comece com um corpo de dados mock OpenAPI, confira o status e a origem e aumente a quantidade quando o teste precisar de um lote.