> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Часто задаваемые вопросы о вебхуках

> Ответы на самые распространенные вопросы о вебхуках, включая управление, поддержку сетей, повторные попытки и устранение неполадок

## Кредиты и ограничения частоты запросов

<Accordion title="How many addresses can I input for 1 webhook?">
  До 100 000 адресов при использовании [API](/docs/ru/api-reference/webhooks/create-webhook).
</Accordion>

<Accordion title="Will I be charged credits if I change the webhook URL in the Helius dashboard after creating the webhook?">
  Да, изменение вебхука через API или панель управления стоит 100 кредитов за запрос. Это относится к любым изменениям, включая смену URL, добавление или удаление адресов и обновление типов транзакций.
</Accordion>

<Accordion title="How many credits does it cost to receive a webhook notification?">
  Каждое событие вебхука стоит 1 кредит, когда Helius обрабатывает и отправляет событие на вашу конечную точку. Плата взимается независимо от того, успешно ли ваша конечная точка обработала вебхук или вернула ошибку.
</Accordion>

<Accordion title="How much does it cost to create, edit, and delete webhooks?">
  Все операции управления вебхуками (создание, изменение и удаление), выполняемые через API, стоят 100 кредитов за запрос. Эта стоимость покрывает обработку, необходимую для обновления конфигураций вебхуков.
</Accordion>

## Поддерживаемые сети

<Accordion title="Are webhooks available on Solana Devnet?">
  Да. Если вы создаете вебхук через пользовательский интерфейс, выберите «devnet» в поле «Сеть». Если вы создаете его через Webhook API, задайте для параметра «webhookType» значение "rawDevnet", "enhancedDevnet" или «discordDevnet» в зависимости от нужного типа вебхука.
</Accordion>

<Accordion title="Can I input 'localhost' for my webhook URL?">
  Нет — URL должен быть общедоступен по протоколу HTTPS. Helius не может обращаться к локальным серверам разработки через URL-адреса localhost.
</Accordion>

## Использование вебхуков

<Accordion title="How can I verify that the webhook came from Helius?">
  Задайте заголовок авторизации при создании или обновлении вебхука. При отправке данных на конечную точку вашего вебхука Helius возвращает это значение в заголовке `Authorization`, что позволяет проверить подлинность запроса.
</Accordion>

<Accordion title="What is the difference between 'raw' and 'enhanced' webhooks?">
  **Необработанные вебхуки** возвращают обычные данные транзакций Solana непосредственно из блокчейна. Когда для отслеживаемых адресов происходит транзакция, необработанные данные транзакции отправляются на URL вашего вебхука.

  **Расширенные вебхуки** предоставляют типы транзакций, интерпретированные Helius. Мы анализируем более 100 типов транзакций Solana (размещение NFT, обмены DeFi, переводы и т. д.) и преобразуем их в собственную схему.

  Используйте необработанные вебхуки, если вам нужны все данные транзакций без абстракций, или расширенные вебхуки, если вам нужны встроенные определение и анализ типов транзакций.
</Accordion>

<Accordion title="When does the Webhook send a notification?">
  Вебхуки отправляют уведомления сразу после подтверждения соответствующей транзакции в блокчейне.
</Accordion>

## Повторные попытки

<Accordion title="How should my endpoint acknowledge a webhook event?">
  Чтобы подтвердить успешное получение, ваша конечная точка должна вернуть код состояния `200` в течение **1 секунды**. Рекомендуется немедленно отвечать кодом `200` и выполнять всю обработку асинхронно — это предотвращает истечение времени ожидания из-за медленной бизнес-логики.
</Accordion>

<Accordion title="What is the retry policy for webhooks?">
  Helius повторяет доставку, если ваша конечная точка возвращает ошибку `5xx`, ошибку `4xx` (кроме `403`), превышает время ожидания либо завершается сбоем из-за ошибки подключения или DNS. Мы выполняем до **3 повторных попыток** с **интервалом в 1 секунду** между ними.

  Если все повторные попытки завершаются неудачно, событие **безвозвратно теряется** — оно не добавляется в очередь повторно и второй цикл доставки не запускается.

  Отслеживайте журналы вебхуков в [панели управления Helius](https://dashboard.helius.dev/webhooks), чтобы выявлять сбои доставки и исследовать проблемы с конечной точкой.

  Для корпоративных тарифов мы также предлагаем настраиваемые политики повторных попыток.
</Accordion>

<Accordion title="Is a webhook event delivered exactly once?">
  Helius может доставить одно и то же событие вебхука несколько раз. Это может произойти из-за логики повторных попыток или проблем с сетью.

  Ваш обработчик вебхуков должен корректно обрабатывать дубликаты — многократная обработка одного события должна давать тот же результат, что и однократная.

  Для обработки дубликатов используйте подпись транзакции или уникальный идентификатор события, чтобы отслеживать уже обработанные события.
</Accordion>

<Accordion title="Do webhooks post failed transactions?">
  Это зависит от типа вебхука. Расширенные вебхуки не отправляют неуспешные транзакции, а необработанные вебхуки включают как успешные, так и неуспешные транзакции.
</Accordion>

## Автоматическое отключение

<Accordion title="Why was my webhook automatically disabled?">
  Helius отслеживает состояние конечных точек и автоматически отключает вебхуки с **долей сбоев доставки ≥ 95%**. Платные тарифы (Dev и выше) оцениваются за 7-дневный период, а вебхуки бесплатного тарифа — за 24-часовой период. Это предотвращает бесполезные попытки доставки на недоступные конечные точки.

  К распространенным причинам относятся недоступный URL конечной точки, постоянный возврат сервером ответов с ошибками и проблемы с сетью или межсетевым экраном, блокирующие доставку от Helius.
</Accordion>

<Accordion title="How do I re-enable a disabled webhook?">
  1. Устраните основную проблему с конечной точкой.
  2. Войдите в [панель управления Helius](https://dashboard.helius.dev/webhooks).
  3. Найдите отключенный вебхук и снова включите его.

  Вебхуки также можно повторно включить программно через [конечную точку API для переключения вебхука](/docs/ru/api-reference/webhooks/toggle-webhook), отправив запрос PATCH с `{ "active": true }`.
</Accordion>

<Accordion title="Will my webhook get disabled again right after I re-enable it?">
  Нет. После повторного включения вебхука начинается **24-часовой льготный период**, в течение которого он не будет отключен автоматически. Это дает вам время убедиться в исправности конечной точки до следующей проверки.
</Accordion>

<Accordion title="Will I be notified when a webhook is auto-disabled?">
  Да — пользователи тарифа **Dev и выше** получают уведомление по электронной почте, когда вебхук автоматически отключается. Пользователи бесплатного тарифа могут отслеживать состояние вебхуков в [панели управления Helius](https://dashboard.helius.dev/webhooks).
</Accordion>

<Accordion title="Can I disable a webhook without deleting it?">
  Да. Вебхуки можно включать и отключать в [панели управления Helius](https://dashboard.helius.dev/webhooks) или через [конечную точку API для переключения вебхука](/docs/ru/api-reference/webhooks/toggle-webhook). Это позволяет временно приостановить доставку, не теряя конфигурацию вебхука.
</Accordion>

## Устранение неполадок вебхуков

<Accordion title="Why is my webhook dropping data?">
  Потеря данных обычно происходит, когда ваша конечная точка сталкивается с ошибкой, из-за чего начинаются повторные попытки доставки вебхука, которые в итоге завершаются неудачно и приводят к потере данных. Проверьте журналы вебхука в [панели управления](https://dashboard.helius.dev/webhooks), убедитесь, что на стороне клиента ведется достаточно подробное журналирование, и [обратитесь в службу поддержки](/docs/ru/support/contact-support), если проблема сохраняется.
</Accordion>

<Accordion title="Why aren't my webhooks working?">
  Убедитесь, что выбранный тип транзакции соответствует отслеживаемым транзакциям. Начните с типа транзакции "ANY", чтобы определить, связана ли проблема с общим сбоем или несоответствием типа. Используйте [webhook.site](http://webhook.site/), чтобы проверить, не связана ли проблема с конфигурацией вашей конечной точки.
</Accordion>

<Accordion title="Why does my webhook not send me all transactions of a certain type (such as TOKEN_MINT)?">
  Вебхук `TOKEN_MINT` срабатывает только для определенных программ, таких как Candy Machine V1 и Solana Program Library. Он не охватывает все события выпуска токенов во всем блокчейне. Для более широкого мониторинга рассмотрите возможность использования более общей подписки на учетную запись или программу через вебхуки с фильтрацией по типу транзакции "ANY".
</Accordion>

***

## Нужна дополнительная помощь?

<CardGroup cols={2}>
  <Card title="Contact Support" icon="headset" href="/docs/ru/support/contact-support">
    Получите помощь нашей команды через Discord, чат или электронную почту.
  </Card>

  <Card title="Status Page" icon="wave-pulse" href="/docs/ru/support/status-page">
    Проверьте доступность сервисов и сведения об их производительности в реальном времени.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.