Saltar al contenido principal
Una editorial que licencia su contenido a Telepatia puede informar a Telepatia cuando un documento cambia. Telepatia obtiene la nueva versión desde la API de la editorial, la prepara y la sirve en la biblioteca de conocimiento. Telepatia Intelligence cita la nueva versión en sus próximas respuestas. La notificación lleva solo el id del documento. Nunca lleva contenido ni una URL. Telepatia obtiene el documento desde la fuente que la editorial y Telepatia acordaron.

Antes de empezar

Necesitas dos cosas de Telepatia:
  1. Una API key con el permiso de editorial. La key tiene library:notify:<publisher>, por ejemplo library:notify:moc. Una key sin este permiso recibe 403. Una key puede notificar solo para una editorial.
  2. 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

  1. Telepatia obtiene el documento desde tu API.
  2. Cuando el contenido es igual a la versión que Telepatia sirve, nada cambia.
  3. 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.
  4. Cuando Telepatia aún no tiene el documento, Telepatia lo agrega a la biblioteca.
Las notificaciones del mismo documento se procesan una tras otra, en el orden en que llegan.

Reintentos

  • Un reintento con el mismo eventId es seguro. Telepatia procesa cada eventId una vez.
  • Con 503, reintenta con el mismo eventId. Usa una espera creciente, por ejemplo 1, 5 y 30 minutos.
  • No reintentes con 400, 401 o 403. Corrige primero la solicitud o la key.