Adicionar um destino
Para onde a fonte repassa o que recebe: uma URL sua. A mensagem vai com o corpo e o
Content-Type originais do provedor, assinada com o secret do destino nos mesmos headers
notyfacil-id, notyfacil-timestamp e notyfacil-signature do envio: o seu código
verifica do mesmo jeito.
Nenhum header do PROVEDOR é encaminhado, de propósito: repassar a assinatura dele faria o
seu sistema achar que verificou a origem quando quem assinou a requisição fomos nós. O que
vai, além da assinatura, são fatos nossos sobre a mensagem: Notyfacil-Source com a fonte,
Notyfacil-Provider com o código do provedor, e Notyfacil-Provider-Event-Id com o id do
evento na ponta, quando extraível. É por este último que você deduplica o reenvio do
provedor sem precisar cavar o corpo.
O secret aparece só nesta resposta. A URL passa pela mesma validação dos endpoints, os headers fixos seguem as mesmas regras, e cada fonte aceita até 10 destinos.
Na leitura, o valor do header fixo volta mascarado para quem tem papel somente leitura no painel, pelo mesmo motivo do envio: ele costuma carregar credencial.
Autorização
Seção intitulada “Authorizations”Parâmetros
Seção intitulada “Parameters”Parâmetros de caminho
Seção intitulada “Path Parameters”Corpo da requisiçãoobrigatório
Seção intitulada “Request Bodyrequired”object
Exemplo
{ "url": "https://api.padariadoze.com.br/pagamentos/webhook", "description": "Backend de pagamentos"}Respostas
Seção intitulada “Responses”Criado.
object
Exemplogerado
{ "id": "example", "url": "example", "secret": "example"}Chave de API ausente, inválida ou revogada.
A fonte não existe, ou não é deste ambiente.
URL ausente ou recusada pela validação, header inválido, ou a fonte já tem 10 destinos.
object
Exemplogerado
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}Limite de requisições por segundo do plano, somado entre todas as chaves da organização.
Headers
Seção intitulada “Headers”Segundos até a próxima janela.