# Webhooks

Используйте Webhooks для получения событий задач и выставления счетов без опроса. Tripo отправляет полезные данные JSON на вашу конечную точку HTTPS при возникновении подписанных событий.

## Настройка

1. Откройте «Настройки», затем Webhooks.
2. Добавьте конечную точку HTTPS, например `https://api.yourapp.com/tripo-webhook`.
3. Выберите типы событий, которые вы хотите получать.
4. Сохраните конечную точку.
5. Скопируйте секрет подписи и надежно сохраните его. Оно отображается только один раз.

## Типы событий

| Событие | Описание |
| --- | --- |
| `task.completed` | Задача завершена успешно. |
| `task.failed` | Задача не выполнена или была отменена. |
| `balance.low` | Баланс счета упал ниже настроенного порога кредитного оповещения. |

## Заголовки запросов

| Заголовок | Описание |
| --- | --- |
| `Tripo-Webhook-Id` | Webhook конечная точка ID. |
| `Tripo-Webhook-Delivery` | Уникальная поставка ID. Используйте его для идемпотентности. |
| `Tripo-Webhook-Event` | Тип события, например `task.completed`. |
| `Tripo-Webhook-Signature` | Подпись HMAC-SHA256 поверх `{timestamp}.{raw_body}`. |
| `Content-Type` | Всегда `application/json`. |

## Проверка

1. Разберите `t` и `v1` из `Tripo-Webhook-Signature`.
2. Вычислите HMAC-SHA256 с секретом подписи над `t + "." + rawBody`.
3. Сравните вычисленный шестнадцатеричный дайджест с `v1`, используя сравнение с постоянным временем.
4. При необходимости отклоняйте временные метки старше пяти минут.

## Лучшие практики

- Быстро верните ответ `2xx`, а затем асинхронно обработайте тяжелую работу.
- Проверьте каждую полезную нагрузку перед изменением состояния приложения.
- Дедупликация событий с помощью `Tripo-Webhook-Delivery`.
- Используйте `balance.low`, чтобы предупредить пользователей до того, как создание задачи завершится сбоем из-за недостаточного количества кредитов.