Antes de começar
Você precisa de duas coisas da Telepatia:- Uma API key com a permissão de editora. A key tem
library:notify:<publisher>, por exemplolibrary:notify:moc. Uma key sem essa permissão recebe403. Uma key notifica para uma única editora. - O id de documento combinado. Cada documento tem um
externalId: o seu próprio id para ele. A Telepatia e você combinam o formato desse id uma vez. A Telepatia guarda o id em cada documento.
Enviar uma notificação
Envie uma requisição cada vez que um documento muda:
Uma resposta
202 Accepted significa que a Telepatia enfileirou a notificação:
O que a Telepatia faz
- A Telepatia busca o documento na sua API.
- Quando o conteúdo é igual à versão que a Telepatia serve, nada muda.
- Quando o conteúdo é diferente, a Telepatia guarda como uma nova versão e prepara essa versão. A versão atual continua em serviço até a nova versão ficar pronta.
- Quando a Telepatia ainda não tem o documento, a Telepatia adiciona o documento à biblioteca.
Novas tentativas
- Uma nova tentativa com o mesmo
eventIdé segura. A Telepatia processa cadaeventIduma vez. - Com
503, tente de novo com o mesmoeventId. Use uma espera crescente, por exemplo 1, 5 e 30 minutos. - Não tente de novo com
400,401ou403. Corrija primeiro a requisição ou a key.