Tornar um job ou webhook seguro para repetir
Prompt que protege um job ou webhook contra execução duplicada com chave de idempotência, estados claros e regras de nova tentativa. Cole-o na ferramenta de IA que preferir, que então torna as repetições seguras.
Os resultados dependem da ferramenta, do modelo e do que você digitar.
Prévia do resultado
Exemplo: escrito pela nossa redação, não é uma resposta real de IA.
Risco: o provedor de pagamentos reenvia o mesmo evento se não respondermos em 10 segundos. Chave: ID do evento do provedor, índice único na tabela "eventos_processados", mantida por 30 dias Estados: recebido → em processamento → concluído / falhou Repetição em "concluído": retornar 200 na hora, sem lançar nada Novas tentativas: só timeout e 5xx, no máximo 5, intervalo crescente com variação aleatória, depois para a lista de falhas Testes: enviar o evento duas vezes; interrupção depois do lançamento; duas entregas ao mesmo tempo Premissa: o banco de dados suporta transações.
Preencher
O que você digita fica nesta janela do navegador. Não armazenamos nem enviamos nada.
- webhook de um provedor de pagamento lança um pagamento
- job envia faturas por e-mail
- importação cria pedidos da loja
- job busca dados na API de um parceiro
- endpoint cria uma conta de cliente
- o pagamento é lançado duas vezes
- o cliente recebe o mesmo e-mail duas vezes
- o pedido aparece duas vezes no estoque
- os contadores sobem em dobro
- duas contas com o mesmo e-mail
- Python com PostgreSQL e uma fila de jobs
- Node.js com Redis
- Java com Spring e Kafka
- PHP com MySQL e cron
- Go com uma fila de mensagens na nuvem
Seu prompt
Você editou o prompt. As mudanças nos campos acima não o substituem mais.
Isto é uma instrução para uma IA, ainda não o resultado.
Onde este prompt funciona
Estas ferramentas de IA combinam com este prompt:
Como usar
- Preencha os campos ou toque em uma sugestão. Deixe de fora nomes, endereços e outros dados pessoais.
- Copie o prompt pronto para a ferramenta de IA que preferir.
- Antes de colocar no ar, injete de propósito eventos duplicados e interrupções num ambiente de testes e confira se cada efeito acontece exatamente uma vez.
Por que funciona?
Na dúvida, redes e filas entregam duas vezes em vez de nenhuma. Uma chave e estados claros transformam o "tomara que seja só uma vez" num "tem efeito exatamente uma vez" que dá para testar.
Dicas
- Guarde a chave na mesma transação da alteração real; caso contrário, sobra uma brecha entre as duas.