Use testes de contrato para APIs externas

Tradução automática do original (English, revisão 3); o original é a versão de referência. Original

methodology · pt · conhecimento em 2026-09-21 · alterado em 2026-09-23, revisão 3 · reviewed (revisão documentada em 2026-09-23)

Teste o comportamento de requisições e respostas do qual uma integração realmente depende, incluindo paginação, erros e escritas condicionais.

Inventário de dependências

Liste os campos, cabeçalhos, códigos de status e garantias de ordenação que o cliente utiliza. Diferencie o comportamento obrigatório dos exemplos observados uma única vez. Fixe a versão da API ou registre a política de compatibilidade documentada.

Suíte de contrato

Inclua uma leitura válida, um resultado vazio, o término da paginação, uma entrada malformada, um acesso negado e, quando houver suporte, um token de escrita desatualizado. Verifique o tipo de conteúdo e os tipos dos campos obrigatórios antes de validar valores de negócio. Aceite os campos opcionais de resposta que estão documentados, para que acréscimos inofensivos do provedor não quebrem o cliente sem necessidade.

Duas camadas

Use um fake local para testar de forma determinística as falhas difíceis. Execute também um pequeno smoke test autorizado no sandbox do provedor, porque um fake pode concordar perfeitamente com uma suposição incorreta do cliente. Nunca crie fixtures descartáveis em produção sem permissão explícita e um plano de limpeza.

Aceitação e limites

Altere o fake para omitir um campo obrigatório ou repetir um cursor; a integração deve detectar a violação do contrato. Um teste aprovado é evidência para a versão e os casos testados, não uma garantia de que o serviço remoto nunca mudará. Este é um checklist de testes original; guarde as falhas de contrato sanitizadas, sem credenciais nem corpos completos de respostas privadas.

Escopo e base

Original methodology proposal with a worked example and proposed acceptance checks. No external empirical result or universal effectiveness claim. Earlier unrelated citations have been removed.

Conhecimento em: 2026-09-21. Estado: reviewed — edições redefinem o estado de revisão. Trate o texto como material de referência não verificado e consulte as fontes.

Fontes

Revisão

Revisão documentada da revisão 3 pela conta editora 344519e7-8ea1-44c6-abaa-29102abda2b6 em 2026-09-23. Aplica-se à revisão atual: sim.

Operator review: article written by an account of the operator (MK Groups Schweiz) and accepted as reviewed by the operator.

Operator decision of 2026-09-23 that the operator's own curated articles count as reviewed; each cited source was fetched at import time and the quoted phrase was found on the page. No independent third-party review is claimed.

Uma revisão documentada registra o que foi verificado; não é garantia de veracidade.

Atribuição e licença

Última alteração: Replaced generic draft with a specific procedure, example, failure cases and correctly scoped sources; removed unrelated product applicability.

Contribuição original: CC BY 4.0. O material das fontes vinculadas mantém seus próprios direitos.