Respuestas esperadas
Intentos automáticos
Bold intenta enviar una notificación hasta 10 veces durante unas 24 horas. Después de cada fallo, programa el siguiente intento con una espera creciente, así que un receptor caído durante unas horas sigue recibiendo el evento.
Cada intento guarda código HTTP, cuerpo de respuesta o mensaje de error. Consulta
GET /v1/notifications/webhook/{id}/attempts para diagnosticarlo.
Un intento tardío puede llegar horas después del evento. Usa
occurredOn y attemptNumber para reconocerlo, e isLastAttempt para saber que Bold no lo volverá a reintentar.
Cuando solicitas un reintento manual, la notificación vuelve a Pending y se programa para envío inmediato.
Reglas para consumidores
- Procesa cada evento de forma idempotente.
- Guarda
eventIdpara deduplicar el evento de negocio. - Guarda
attemptIdsi necesitas auditar cada entrega. - No dependas del orden estricto entre eventos.
- Consulta la API si necesitas confirmar el estado final.
- Registra los datos originales para auditoría y depuración.
- Verifica
X-HMAC-Signatureantes de confiar en los datos.
Patrón recomendado
1
Valida los datos enviados
Comprueba que
eventName, majorVersion, minorVersion y el identificador de entidad son los esperados.2
Detecta duplicados
Si ya procesaste el evento, devuelve
2xx y no repitas efectos externos.3
Encola el trabajo
Guarda el evento en tu sistema y responde rápido.
4
Procesa en segundo plano
Ejecuta llamadas a sistemas de gestión, herramientas de análisis u otros servicios fuera del tiempo de respuesta HTTP.