Skip to main content

​
Créditos e Limites de Taxa

Até 100.000 endereços usando a API.
Sim, editar um webhook via API ou painel custa 100 créditos por requisição. Isso se aplica a qualquer modificação, incluindo mudanças de URL, adição/remoção de endereços ou atualização de tipos de transações.
Cada evento de webhook custa 1 crédito quando a Helius processa e envia o evento para o seu endpoint. Você é cobrado, independentemente de o seu endpoint processar o webhook com sucesso ou retornar um erro.
Todas as operações de gerenciamento de webhook (criar, editar, excluir) custam 100 créditos por requisição quando realizadas via API. Isso cobre o processamento necessário para atualizar suas configurações de webhook.

​
Redes Suportadas

Sim. Se você criar um webhook através da interface, escolha “devnet” como “Network”. Se criar através da Webhook API, defina o parâmetro “webhookType” como “rawDevnet”, “enhancedDevnet” ou “discordDevnet”, dependendo do tipo de webhook desejado.
Não — a URL deve ser publicamente acessível via HTTPS. A Helius não pode acessar servidores de desenvolvimento local por URLs localhost.

​
Usando Webhooks

Defina um cabeçalho de autorização ao criar ou atualizar o webhook. A Helius ecoa esse valor no cabeçalho Authorization ao enviar dados para seu endpoint de webhook, permitindo que você verifique a autenticidade da solicitação.
Raw webhooks retornam dados regulares de transação Solana diretamente da blockchain. Quando ocorre uma transação para os endereços monitorados, os dados da transação bruta são enviados para a sua URL de webhook.Enhanced webhooks fornecem tipos de transações interpretados pela Helius. Nós analisamos mais de 100 tipos de transações Solana (listas de NFT, trocas DeFi, transferências, etc.) e as abstraímos em nosso próprio esquema.Use raw webhooks se você quiser todos os dados de transação sem abstrações, ou enhanced webhooks se quiser detecção e análise de tipo de transação integrada.
Os webhooks enviam notificações imediatamente após uma transação correspondente ser confirmada na blockchain.

​
Tentativas

Seu endpoint deve retornar um código de status 200 em 1 segundo para reconhecer o recebimento bem-sucedido. Como melhor prática, responda com 200 imediatamente e lide com qualquer processamento de forma assíncrona — isso previne timeouts causados por lógica de negócios lenta.
A Helius tenta novamente a entrega quando seu endpoint retorna um erro 5xx, um erro 4xx (exceto 403), tempos de espera ou falhas devido a um erro de conexão ou falha de DNS. Tentamos novamente até 3 vezes com um intervalo de 1 segundo entre cada tentativa.Se todas as tentativas de reenvio falharem, o evento é permanentemente perdido — não há re-fila ou segundo ciclo de entrega.Monitore os seus registros de webhook no Painel Helius para identificar falhas de entrega e investigar problemas do endpoint.Também oferecemos políticas de tentativas personalizáveis para planos empresariais.
A Helius pode entregar o mesmo evento de webhook várias vezes. Isso pode acontecer devido à lógica de tentativas ou problemas de rede.Seu manipulador de webhooks deve estar preparado para lidar com duplicatas graciosamente — processar o mesmo evento várias vezes deve produzir o mesmo resultado que processá-lo uma vez.Para lidar com duplicatas, use a assinatura da transação ou um identificador único de evento para acompanhar quais eventos você já processou.
Depende do tipo de webhook. Webhooks aprimorados não enviam transações falhas, mas webhooks brutos incluem tanto transações bem-sucedidas quanto falhas.

​
Desativação Automática

A Helius monitora a saúde do endpoint e desativa automaticamente os webhooks com uma taxa de falha de entrega ≥ 95%. Planos pagos (Dev e acima) são avaliados em uma janela de 7 dias, enquanto webhooks do plano gratuito são avaliados em uma janela de 24 horas. Isso previne tentativas de entrega desperdiçadas contra endpoints inacessíveis.Causas comuns incluem uma URL de endpoint inacessível, seu servidor retornando respostas de erro consistentes ou problemas de rede/firewall bloqueando entregas da Helius.
  1. Corrija o problema subjacente com seu endpoint.
  2. Faça login no Painel Helius.
  3. Encontre o webhook desativado e reative-o.
Você também pode reativar webhooks programaticamente via Ponto de extremidade da API Toggle Webhook enviando uma requisição PATCH com { "active": true }.
Não. Após reativação, o webhook entra em um período de carência de 24 horas durante o qual não será desativado automaticamente. Isso lhe dá tempo para verificar se o seu endpoint está saudável antes da próxima avaliação.
Sim — usuários no plano Dev e acima recebem uma notificação por e-mail quando um webhook é desativado automaticamente. Usuários do plano gratuito podem monitorar o status do webhook no Painel Helius.
Sim. Você pode alternar webhooks entre ativado e desativado no Painel Helius ou via Ponto de extremidade da API Toggle Webhook. Isso permite pausar temporariamente as entregas sem perder sua configuração de webhook.

​
Solução de Problemas com Webhooks

A perda de dados geralmente ocorre quando seu endpoint encontra um erro, causando tentativas de reenvio de webhook que eventualmente falham e levam à perda de dados. Verifique seus registros de webhook no painel, certifique-se de que haja um registro suficiente no lado do cliente e entre em contato com o suporte se o problema persistir.
Certifique-se de que o tipo de transação selecionado corresponda às transações que você está monitorando. Comece com o tipo de transação “ANY” para identificar se é um problema geral ou incompatibilidade de tipo. Use webhook.site para testar se o problema está na configuração do seu endpoint.
O webhook TOKEN_MINT apenas aciona para programas específicos como Candy Machine V1 e Solana Program Library. Ele não cobre todos os eventos de mintagem de token em toda a blockchain. Para monitoramento mais amplo, considere usar uma assinatura de conta ou programa mais geral via webhooks com filtro de tipo de transação “ANY”.

​
Precisa de Mais Ajuda?

Contatar Suporte

Obtenha ajuda da nossa equipe através do Discord, chat ou suporte por e-mail.

Página de Status

Verifique a disponibilidade e informações de desempenho do serviço em tempo real.