ReboundAmbientes suportados
| Integração | Requisitos | Uso |
|---|---|---|
| SDK Node.js | Node.js 20+ | Pacote @rebound-dlq/node para backend; não execute no navegador. |
| HTTP · Node.js | Node.js 20+ | crypto e fetch nativos, sem dependências adicionais. |
| HTTP · PHP | PHP 8.4+ · OpenSSL · cURL | Cliente de exemplo em PHP puro; não é um SDK oficial PHP. |
| HTTP · Python | Python 3.11+ · cryptography | Transporte da biblioteca padrão e AES com cryptography; não é um SDK oficial Python. |
| HTTP · cURL | cURL · Node.js 20+ | Node prepara corpo e assinatura; cURL envia os mesmos bytes. |
Versão da API e ambientes
Os exemplos usam a API v1, identificada pelo prefixo /api/v1. No Cloud, use https://api.rebound-dlq.com/api/v1. No Self-hosted, use a URL HTTPS da sua instalação com o mesmo prefixo. Nunca misture segredos de projetos ou ambientes diferentes.
Confira e atualize seu SDK
Confira a versão instalada no seu projeto e consulte as notas da versão antes de atualizar. Mantenha o package-lock.json no controle de versão para que desenvolvimento, CI e produção instalem a mesma árvore de dependências.
Valide a atualização em um projeto de teste: envie uma captura, confira a confirmação e o histórico no painel e teste o encerramento com close. Se sua instalação não expuser flush, close ou onDelivery, não copie esses trechos para uma versão antiga: atualize o pacote e confira as notas da versão.
npm ls @rebound-dlq/node
npm outdated @rebound-dlq/node
npm install @rebound-dlq/node@latestCompatibilidade e agrupamento
eventId é opcional no contrato v1 para manter compatibilidade com clientes antigos. Envie um UUID v4 por ocorrência e reutilize-o nos reenvios para ter proteção contra duplicação. Sem esse campo, uma nova tentativa pode contar como outra ocorrência.
O SDK usa fingerprintVersion legacy por padrão; v2 é uma escolha explícita. Mudar a versão do fingerprint ou o contexto de fluxo pode criar novos grupos de erros. Valide o agrupamento antes de alterar essa configuração e mantenha a mesma estratégia entre serviços que reportam o mesmo tipo de falha.