Secção Desenvolvedores
O que é a secção Desenvolvedores?
Nesta secção encontrará ferramentas pensadas para facilitar as tarefas de integração à sua equipa de desenvolvimento.
- Vá ao menu vertical da esquerda e selecione «Desenvolvedores».
- Verá três separadores: Logs de API, Notificações e Webhooks.
Separador Logs de API
Os Logs de API mostram todos os pedidos efetuados à nossa API e as respostas devolvidas. É útil para depurar erros de integração.
Filtros disponíveis
- Filtro de data como chip persistente.
- Seletor de código de resposta: filtra por código HTTP (200, 201, 400, 401, 404, 408, 500).
- Botão «Filtros»: adiciona chips adicionais como Método (método HTTP do pedido).
🧐 O separador Logs de API não tem botão de Exportar CSV.
Que informação tenho de cada log?
Ao expandir um log (clicando sobre ele) verá três blocos:
- Informação: ID do log, URL do pedido, data e hora, e parâmetros GET.
- Pedido: JSON completo enviado à API, com ícone para o copiar.
- Resposta: JSON de resposta devolvido pela nossa API, com ícone para o copiar.
Separador Notificações
As notificações são os avisos que o Zru envia ao seu servidor quando ocorrem eventos nas transações (para a notify_url definida ao criar uma transação, subscrição ou autorização por API).
A partir deste separador pode ver todas as notificações enviadas, a resposta que o seu servidor devolveu e reenviá-las se for necessário.
Filtros disponíveis
- Seletor de pesquisa: ID, ID Externo ou URL de Notificação.
- Filtro de data como chip persistente.
- Seletor de código de resposta e botão Filtros para adicionar chips adicionais.
- Botão Exportar CSV.
Que informação tenho de cada notificação?
🧐 Para expandir uma notificação, clique sobre ela na lista.
✋ Se não conseguir clicar ou não conseguir reenviar a notificação, é porque não tem as permissões necessárias. Fale com o proprietário do ambiente para que lhas ative.
- Informação: ID de notificação, URL de notificação, data e hora, e se é uma Notificação de falha.
- Pedido: JSON completo enviado pelo nosso sistema ao seu servidor, copiável.
- Resposta: resposta devolvida pelo seu servidor, copiável.
Como voltar a enviar uma notificação?
- Vá a Desenvolvedores ▶︎ Notificações.
- Localize a notificação que pretende reenviar usando os filtros ou a pesquisa.
- Clique sobre ela para expandir os seus detalhes.
- No bloco Ações, clique em «Reenviar».
Separador Webhooks
Os Webhooks permitem-lhe configurar os endpoints para onde o Zru enviará notificações de forma global para todo o ambiente.
A lista mostra o Nome, a URL, o Tipo de eventos subscritos e se está Habilitado. Com o botão «Adicionar Webhook» pode criar um novo.
Para aprender a configurá-los, consulte este guia.
🧐 A diferença entre Webhooks e Notificações: os Webhooks são a configuração do endpoint (para que URL enviar). As Notificações são os eventos concretos enviados a esses endpoints, com o seu pedido e a sua resposta.
Actualizado em: 21/08/2026
Obrigado!
