Pôr os sistemas a comunicar sem perder o controlo dos dados
Uma boa API não se avalia apenas quando tudo funciona. Avalia-se sobretudo quando o serviço remoto abranda, envia duas vezes o mesmo evento ou fica indisponível.
Prever os casos de falha
Prevemos autenticação, validação, idempotência, retoma, registos e gestão de erros consoante a criticidade do fluxo.
Uma integração deve ser observável
Deve ser possível responder a perguntas simples:
- o que enviámos?
- o que recebemos, e quando?
- porque falhou a operação?
- pode ser reexecutada sem criar um duplicado?
Estas informações reduzem consideravelmente o tempo de diagnóstico em produção.
Sistemas para ligar?
Enumere os programas que têm de trocar dados: identificaremos os fluxos críticos e os seus casos de falha.