Antes de empezar
Necesitas dos cosas de Telepatia:- Una API key con el permiso de editorial. La key tiene
library:notify:<publisher>, por ejemplolibrary:notify:moc. Una key sin este permiso recibe403. Una key puede notificar solo para una editorial. - El id de documento acordado. Cada documento tiene un
externalId: tu propio id para él. Telepatia y tú acuerdan el formato de este id una vez. Telepatia lo guarda en cada documento.
Enviar una notificación
Envía una solicitud cada vez que un documento cambia:
Una respuesta
202 Accepted significa que Telepatia encoló la notificación:
Qué hace Telepatia
- Telepatia obtiene el documento desde tu API.
- Cuando el contenido es igual a la versión que Telepatia sirve, nada cambia.
- Cuando el contenido es distinto, Telepatia lo guarda como una nueva versión y la prepara. La versión actual sigue en servicio hasta que la nueva versión está lista.
- Cuando Telepatia aún no tiene el documento, Telepatia lo agrega a la biblioteca.
Reintentos
- Un reintento con el mismo
eventIdes seguro. Telepatia procesa cadaeventIduna vez. - Con
503, reintenta con el mismoeventId. Usa una espera creciente, por ejemplo 1, 5 y 30 minutos. - No reintentes con
400,401o403. Corrige primero la solicitud o la key.