Генерация завершена успешно

Если при submit был передан webhook_url, Clipia отправит POST на этот URL по успешном завершении генерации.

Заголовки подписи (HMAC-SHA256):

  • X-Clipia-Webhook-Id — UUID доставки.
  • X-Clipia-Timestamp — Unix-время (секунды).
  • X-Clipia-Signature — формат t=<ts>,v1=<hmac>, где hmac = HMAC_SHA256(secret, "{timestamp}.{raw_body}") в hex. secret — webhook signing secret из личного кабинета.

Проверяйте подпись timing-safe сравнением и отбрасывайте доставки старше окна свежести (по умолчанию 300 секунд). Обрабатывайте идемпотентно по request_id (возможна повторная доставка). Ожидается ответ 2xx в течение 10 секунд; иначе — ретраи с экспоненциальной задержкой до 6 попыток.

postWebhookgeneration.completed

Headers

X-Clipia-Webhook-Idstring uuid required

UUID доставки вебхука.

X-Clipia-Timestampinteger required
Example:1717243200

Unix-время доставки (секунды). Используется для проверки свежести.

X-Clipia-Signaturestring required
Example:t=1717243200,v1=5257a869e7d1f3...

Подпись доставки в формате t=<ts>,v1=<hmac>, где hmac = HMAC_SHA256(secret, "{timestamp}.{raw_body}") в hex.

Payload

request_idstring uuid required
status'OK' required

Признак успеха.

Example payload

{
  "payload": {
    "model": "nano-banana-2"
  }
}

Response

Доставка принята получателем.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.