Вебхуки
Проверяйте подпись времени, точки и точного исходного тела. Сохраняйте ID событий для защиты от дублей. Повторная доставка не повторяет генерацию.
Добавить вебхук#
curl -X POST 'https://platform.tongai.io/v1/webhook-endpoints' \ -H "Authorization: Bearer $TONG_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: 45be69f1-c266-4a09-a82c-bf3c6303eb03" \ -d '{ "url": "https://your-app.example/tong/events", "events": [ "operation.succeeded", "operation.failed", "operation.review_required", "usage.settled" ]}'Настройки
curl --versionВыберите ключ или подключение с webhooks:manage и operations:read.
Проверить подпись#
Tong-Event-Id: {event_uuid}Tong-Timestamp: {unix_seconds}Tong-Key-Version: 1Tong-Signature: v1={hex_hmac_sha256}
HMAC_SHA256(signing_secret, timestamp + "." + raw_body)История доставок#
POST /v1/webhook-endpoints/{id}/rotate-secretGET /v1/webhook-endpoints/{id}/deliveriesPOST /v1/webhook-endpoints/{id}/deliveries/{delivery_id}/retryGET /v1/webhook-endpointsПросмотрите свой ресурс или состояние процесса без запуска новой генерации.POST /v1/webhook-endpointsИспользуйте описанные поля и разрешения для этого эндпоинта HTTP.PATCH /v1/webhook-endpoints/{id}Используйте описанные поля и разрешения для этого эндпоинта HTTP.POST /v1/webhook-endpoints/{id}/rotate-secretИспользуйте описанные поля и разрешения для этого эндпоинта HTTP.GET /v1/webhook-endpoints/{id}/deliveriesПросмотрите свой ресурс или состояние процесса без запуска новой генерации.POST /v1/webhook-endpoints/{id}/deliveries/{delivery_id}/retryИспользуйте описанные поля и разрешения для этого эндпоинта HTTP.