Ana içeriğe atla

Genel Bakış

GET /jobs/{id} adresini sorgulamak yerine Krea’ya bir webhook URL’si verin. İş tamamlandığında Krea işi bu URL’ye gönderir.

Webhook Kullanma

Herhangi bir üretim isteğine X-Webhook-URL başlığını ekleyin. İş tamamlandığında, başarısız olduğunda veya iptal edildiğinde Krea bu URL’ye bir POST isteği gönderir.

Webhook Yükü

İstek gövdesi, GET /jobs/{id} yanıtıyla aynı yapıya sahiptir:

İmzaları Doğrulama

Krea her webhook’u Ed25519 ile imzalar. Bir yüke güvenmeden önce imzayı doğrulayın ve imzası olmayan istekleri reddedin. Krea, zaman damgası, URL, meta veriler ve ham istek gövdesinin satır sonlarıyla birleştirilmesiyle elde edilen değerin küçük harfli hex SHA-256 özetini imzalar:
Bir isteği doğrulamak için:
  1. X-Krea-Webhook-Url değerinin, işle birlikte gönderdiğiniz X-Webhook-URL ile tam olarak eşleştiğini kontrol edin.
  2. Zaman damgasının sunucunuzun geçerli saatinden en fazla 5 dakika farklı olduğunu kontrol edin.
  3. İmza, https://api.krea.ai/.well-known/jwks.json içindeki herhangi bir anahtarla doğrulanıyorsa isteği kabul edin. Anahtarları en fazla 24 saat önbelleğe alın. Krea yeni bir anahtarı, onunla imzalamaya başlamadan 24 saat önce yayınlar.
Yeniden serileştirilmiş JSON’u değil, ham gövde baytlarını hash’leyin. Örneğin Express’te express.raw(), Fetch API çerçevelerinde await request.arrayBuffer() veya Flask’ta request.get_data() kullanın. Eksik bir X-Krea-Webhook-Metadata başlığını boş bir dize olarak kabul edin.

Teslimat ve Yeniden Denemeler

15 saniye içinde bir 2xx döndürün. İstek zaman aşımına uğrarsa, bağlantı kurulamazsa veya 5xx, 408, 423, 425 ya da 429 yanıtı alırsa Krea, her seferinde yeni bir zaman damgası ve imzayla yaklaşık 10 dakika boyunca yeniden dener. Krea diğer 4xx yanıtları için yeniden deneme yapmaz. Aynı iş birden fazla kez gelebilir, bu nedenle yinelenenleri job_id ve status alanlarına göre ayıklayın.

Webhook ve Sorgulama Karşılaştırması

HTTP isteği alabilen bir sunucunuz varsa webhook kullanın. İstemci tarafı uygulamalar için veya genel bir uç nokta sunamıyorsanız sorgulama kullanın.

Sonraki Adımlar

İş Yaşam Döngüsü

İş durumları ve durum sorgulaması hakkında bilgi edinin

Kod Örnekleri

API ile baştan sona bir görsel üretin