Вебхуки · UltraGPT API

Вебхуки

Настройте HTTPS-эндпоинт в Настройках для событий balance.low, credits.added, key.created / rotated / revoked, key.spend_cap.warning / reached, key.expiring, account.daily_limit.reached, batch.completed / failed, video.completed / failed и model.deprecated. Каждый POST — JSON { id, type, created, data } с подписью HMAC-SHA256.

Неудачная доставка (не 2xx или таймаут) повторяется через 30 секунд, 5 минут и 30 минут с тем же id события — используйте его для дедупликации. Повторы переживают наши перезапуски. Все попытки видны в настройках, где любое событие можно отправить заново. После 20 неудач подряд вебхук приостанавливается.

import crypto from 'node:crypto'

// UltraGPT-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>">
export function verifyWebhook(rawBody, header, secret, toleranceSec = 300) {
  const parts = Object.fromEntries(header.split(',').map(p => p.split('=')))
  const expected = crypto.createHmac('sha256', secret).update(`${parts.t}.${rawBody}`).digest('hex')
  const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) < toleranceSec
  return fresh && crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1 ?? ''))
}