# Testador de estresse de contrato de API Gera casos de limite a partir de OpenAPI 3.x e opcionalmente envia ao backend real para detectar divergencias do contrato. > Página canônica: https://elysiatools.com/pt/tools/api-contract-stress-tester - **Categoria:** Development - **Palavras-chave:** openapi, contrato, testes limite, api ## Visão geral Cole um documento OpenAPI 3.x em "Especificacao OpenAPI". YAML e JSON sao suportados. O que fornecer: - Um documento OpenAPI 3.x valido com paths, parameters, request bodies e responses - Referencias opcionais em components.schemas para resolver schemas de request body - Uma URL base opcional se quiser enviar os casos gerados para um backend real Como os campos funcionam: - Especificacao OpenAPI: cole o contrato completo em YAML ou JSON - URL base: deixe vazio para gerar casos offline ou use algo como https://api.example.com para executar requisicoes - Executar requisicoes reais: quando ativado, a ferramenta envia requisicoes invalidas ou de borda para a URL base - Cabecalho de autorizacao: valor bruto opcional, como Bearer \- Casos maximos por campo: limita quantos casos de borda sao gerados por parametro ou campo do body - Tempo limite da requisicao (ms): limita quanto cada requisicao real pode durar O que e testado: - Campos obrigatorios ausentes - Strings vazias, curtas demais ou longas demais - Valores enum invalidos - Numeros abaixo do minimum ou acima do maximum - Tipos escalares ou arrays incorretos para campos documentados Notas: - Se "Executar requisicoes reais" estiver desativado, a ferramenta gera apenas um plano de teste de contrato. - Se estiver ativado, o relatorio marca se cada status HTTP observado esta documentado nas responses do OpenAPI. - Path, query, header e JSON body sao cobertos; a versao atual foca em request bodies application/json. ## Entradas - **Especificacao OpenAPI** (textarea): Paste an OpenAPI 3.x YAML or JSON document here... - **URL base** (text): https://api.example.com - **Executar requisicoes reais** (checkbox) - **Cabecalho de autorizacao** (text): Bearer - **Casos maximos por campo** (number) - **Tempo limite da requisicao (ms)** (number) ## Quando usar - Antes de integrar novos endpoints em produção, para garantir que o backend rejeita corretamente requisições malformadas ou fora dos limites. - Durante auditorias de segurança ou testes de robustez para descobrir vulnerabilidades de validação de entrada em APIs RESTful. - Ao atualizar a documentação OpenAPI, para verificar se as regras de schema (como minLength, maximum ou enum) correspondem ao comportamento real do servidor. ## Como funciona - Cole a sua especificação OpenAPI 3.x (em formato YAML ou JSON) no campo principal da ferramenta. - Configure a URL base e o cabeçalho de autorização caso deseje que a ferramenta execute as requisições reais contra o seu servidor. - Ajuste o limite de casos por campo e o tempo limite da requisição para controlar o volume e a duração dos testes de estresse. - Analise o relatório JSON gerado, que detalha os casos de limite criados e aponta quaisquer divergências entre as respostas do servidor e o contrato documentado. ## Casos de uso - Geração automatizada de planos de teste de mutação e limite para equipes de Quality Assurance (QA). - Validação contínua de contratos (Contract Testing) para garantir que o backend respeita as restrições do OpenAPI. - Descoberta de falhas de tratamento de erros (como retornos 500 em vez de 400) em APIs recém-desenvolvidas. ## Perguntas frequentes ### Quais formatos de especificação são suportados? A ferramenta suporta documentos OpenAPI 3.x válidos nos formatos YAML e JSON. ### A ferramenta testa todos os tipos de requisição? Atualmente, ela cobre parâmetros de path, query, header e corpos de requisição em formato JSON (application/json). ### É obrigatório executar requisições reais contra a minha API? Não. Se a opção 'Executar requisições reais' estiver desativada, a ferramenta apenas gerará um plano de testes focado no contrato, sem fazer chamadas de rede. ### Como a ferramenta lida com endpoints que exigem autenticação? Você pode fornecer um token no campo 'Cabeçalho de autorização' (por exemplo, Bearer ) que será incluído em todas as requisições reais executadas. ### O que acontece se o servidor retornar um status HTTP não documentado? O relatório final marcará esse comportamento como uma divergência (mismatch), indicando que o status HTTP observado na prática não está definido nas respostas do seu OpenAPI. ## Ferramentas relacionadas - [Conversor de cURL para Go (net/http)](https://elysiatools.com/pt/tools/curl-to-go): Converte um comando cURL em um snippet de código Go net/http com http.NewRequest, cabeçalhos e corpo - [Conversor de cURL para JavaScript (axios)](https://elysiatools.com/pt/tools/curl-to-js-axios): Converte um comando cURL em um snippet de código JavaScript axios com objeto de configuração, cabeçalhos e dados - [Conversor de cURL para JavaScript (fetch)](https://elysiatools.com/pt/tools/curl-to-js-fetch): Converte um comando cURL em um snippet de código JavaScript fetch() com cabeçalhos, corpo e método - [Conversor de cURL para PHP (cURL)](https://elysiatools.com/pt/tools/curl-to-php): Converte um comando cURL em um snippet de código PHP cURL com curl_setopt, cabeçalhos e campos POST - [Conversor de cURL para Python (requests)](https://elysiatools.com/pt/tools/curl-to-python): Converte um comando cURL em um snippet de código Python requests com cabeçalhos, dados e método - [Sincronizador de paleta Tailwind](https://elysiatools.com/pt/tools/tailwind-color-palette-sync): Insira HEX, escolha o esquema de nomes (escala 50–950 / nome único / aninhamento) e gere o fragmento theme.extend.colors do tailwind.config.ts com níveis WCAG AA/AAA. Dark mode opcional. - [Explicador de Expressões Cron](https://elysiatools.com/pt/tools/cron-expression-explainer): Analisa uma expressão cron (5/6 campos ou Quartz) em uma descrição em linguagem natural, detalha os campos e lista as próximas N execuções em qualquer zona IANA, com explicação por IA - [Testador de mutacao de contrato API](https://elysiatools.com/pt/tools/api-contract-mutation-tester): Aplica mutacoes semanticas a campos OpenAPI e opcionalmente as envia para o backend real para medir a validacao defensiva ## Exemplos - [Coleções Postman - Testes de API](https://elysiatools.com/pt/samples/postman-collections): Exemplos abrangentes de coleções Postman incluindo testes de API, scripts de automação, variáveis de ambiente, servidores mock e padrões avançados de teste para REST APIs - [Exemplos de Processamento de Imagem Web Python](https://elysiatools.com/pt/samples/web-image-processing-python): Exemplos de processamento de imagem Web Python usando PIL/Pillow incluindo leitura, salvamento, redimensionamento e conversão de formato - [Exemplos OpenAI API](https://elysiatools.com/pt/samples/openai): Exemplos abrangentes da API OpenAI incluindo modelos GPT, geração de imagens DALL-E, processamento de áudio Whisper e chamadas de função - [API Gráfica WebGPU](https://elysiatools.com/pt/samples/webgpu): API gráfica moderna para gráficos 3D de alta performance e computação GPU no navegador ## Conteúdo relacionado - [Geradores de schema JSON, dados mock e fixtures de API](https://elysiatools.com/pt/hubs/json-generate): Ferramentas reunidas para geracao de schema JSON, construcao de payloads mock e preparacao de fixtures de API em um unico hub. - [Ferramentas de validação de JSON Schema e contratos de API](https://elysiatools.com/pt/hubs/json-validate): Compare validação de JSON Schema, checagem de resposta OpenAPI, mutation testing, stress testing e detecção de mudanças incompatíveis em um único hub para revisão de contratos de API. - [Ferramentas OpenAPI para documentação, geração de código e revisão de contrato](https://elysiatools.com/pt/hubs/openapi-utility): Compare geração de código OpenAPI, documentação de API, diff de schemas, validação de respostas e testes de contrato em um único hub para design e manutenção de APIs. - [Ferramentas de teste de contrato de API, mocking e revisão de schemas](https://elysiatools.com/pt/hubs/api-contract-testing): Gere tipos e documentação a partir de OpenAPI, crie mocks, valide respostas reais e revise mudanças críticas de schema em um único hub.