Webhooks
Ao ativar o Webhook, sempre que houver alterações nos recursos integrados será feito uma requisição POST, para o endereço configurado contendo o recurso envolvido.
Nesta página:
Habilitando o Webhook
ID da Requisição
Retornando HTTP 200
Retornando HTTP de erro
Token de autenticação
Habilitando o Webhook
Para habilitar o webhook, acesse a área Webhooks, e informe os dados necessários do recurso e URL da aplicação que deve receber o POST do Guru.
ID da Requisição
Cada vez que o webhook é disparado, geramos um ID de requisição e enviamos no HEADER X-Request-ID.
Retornando HTTP 200
Para que o Guru considere o webhook como processado com sucesso, o status HTTP da resposta deve ser 200. Caso seu sistema falhe em responder HTTP 200, a retentativa é feita a cada minuto x número de tentativas até o total de 10 tentativas. Se falhar mais de 10 vezes é enviada uma notificação para todos os usuários administradores.
Retornos HTTP de erro
O Guru não tenta reenviar os webhooks caso o código de retorno seja:
0
401
403
404
406
410
500 ( e tudo que for maior ou igual a 500)
Caso não seja nenhum desses erros tentaremos entregar até 20 vezes, sempre adicionando 1 minuto ao tempo anterior.
Como por exemplo:
2ª tentativa -> 1 minuto depois da primeira
3ª tentativa -> 2 minutos depois da segunda
4ª tentativa -> 3 minutos depois da terceira
5ª tentativa -> 4 minutos depois da quarta
Token de autenticação
Para validar que a requisição do webhook pertence ao Guru, é enviado o campo api_token.