O que você leva
O que você leva quando a encomenda é entregue.
Uma página que decide discussões
O contrato de interface diz o que entra, o que sai e qual erro aparece.
Um ambiente para errar
Chaves próprias, dados falsos e botão de zerar, separados da produção.
Uma fila que não perde envio
Nova tentativa com espera crescente e pendências guardadas à vista.
Avisos que se reenviam
Cada evento tem registro de entrega e botão para mandar outra vez.
Uma versão com data
A interface antiga fica de pé pelo prazo anunciado em contrato.
Um registro para os dois lados
Pedido, resposta e horário guardados pelo prazo combinado.
Sete costumes que evitam o remendo de terça-feira
Integração quebra: a outra ponta muda campo, cai, devolve um erro novo. Estes sete costumes não impedem isso — eles fazem a quebra aparecer cedo, em lugar visível, com caminho de volta. Role de lado para ler.
Contrato antes do código
Quais campos entram, quais saem, o que é obrigatório e qual erro cada caso devolve. Uma página, aprovada pelos dois lados.
Ambiente de teste desde cedo
Chaves separadas, dados falsos e um botão para zerar tudo. Quem integra precisa errar à vontade antes de tocar em produção.
Nova tentativa com espera crescente
Quando a outra ponta não responde, a fila tenta de novo em intervalos maiores e guarda o que ficou pendurado.
Aviso automático que pode ser reenviado
Todo evento importante sai como aviso assinado, com registro do que foi entregue e botão para mandar outra vez.
Versão com data de aposentadoria
Interface muda. Quando muda, a versão antiga continua de pé por um prazo anunciado, e quem usa recebe o aviso antes.
Limite de chamadas explicado
Quantas chamadas por minuto, o que acontece ao passar disso e como o sistema avisa que está perto do teto.
Registro que serve para discutir
Cada chamada guarda pedido, resposta e horário por um prazo combinado. Sem isso, «funcionou aqui» é a única prova de qualquer lado.
Quem parou de descobrir a quebra pelo cliente
Relatos das últimas encomendas, publicados com autorização de cada um.
Os avisos automáticos podem ser reenviados por botão. Isso tirou o desenvolvedor do meio de toda conferência.
A versão antiga da interface ficou de pé pelo prazo anunciado. Nenhum dos meus parceiros ficou de fora na virada.
O registro de pedido e resposta encerrou a discussão de quem errou. Em dois casos o erro era nosso, e deu para arrumar rápido.
A espera crescente segurou quatro horas de instabilidade da outra ponta sem perder um envio sequer.
O relatório mensal mostra chamadas, erros e o que ficou pendurado. É a única página que eu leio inteira.
Diga quais sistemas o seu produto vai ter de encarar
Com a lista das pontas e um exemplo de cada retorno já conseguimos dizer o que é ponte curta, o que é obra e o que é melhor não integrar agora.