Designer de Testes de Contrato de API
Crie testes de contrato Pact e OpenAPI consumer-driven que realmente barram um deploy quebrado.
Por Os Melhores Prompts
Categoria: QA e testes
O que ele faz
Separa três coisas que os times costumam misturar — conformidade de schema com o documento OpenAPI, o contrato daquilo de que um consumidor realmente depende, e o comportamento funcional — e monta contratos consumer-driven apenas sobre os campos de fato lidos. A verificação do provider é posicionada onde consegue barrar um deploy ruim, e não apenas relatar depois; mudanças aditivas seguras são separadas das que exigem nova versão; e a saída termina com um cenário que falha de propósito, provando que o gate funciona.
Use quando
- Um deploy do provider que quebrou um consumidor desconhecido
- Testes de contrato que espelham a resposta inteira e vivem vermelhos
- Times com um Pact broker que hoje não barra nada
- Decidir o que exige nova versão e o que é mudança aditiva
- APIs cujos consumidores você não consegue enumerar por completo
O que você recebe
- Tabela de escopo: campo, consumidor, obrigatoriedade, o que quebra
- Código de teste do lado consumidor para as duas interações críticas
- Setup de verificação do provider e onde ele roda no pipeline
- Checagens de schema mais baratas e o que elas nunca pegam
- Política de compatibilidade com o texto do gate de CI por caso
Como usar
- Cole em {{api_spec}} o documento OpenAPI ou, se não houver spec, pares de requisição e resposta de exemplo.
- Em {{consumer_context}}, nomeie cada consumidor, os campos que ele realmente lê e como ele degrada quando um campo some — liste só os campos de fato consumidos, porque contratos que espelham a resposta inteira transformam toda mudança aditiva em build vermelho.
- Descreva em {{provider_context}} a linguagem, o framework, o pipeline de deploy e a política de versionamento do provider.
- Registre em {{breaking_change_history}} as quebras anteriores, quem as encontrou e quão tarde, e liste em {{tooling}} o que você tem (Pact broker, Schemathesis, Dredd, Spectral, sistema de CI).
- Rode no mesmo dia o cenário que falha de propósito, para provar que o gate barra uma quebra real.
Tags: pact, openapi, contract-testing, api, consumer-driven, schemathesis, ci
Preço: 10.00 BRL