Public API ve webhook’lar

LoraLook’u kendi sistemlerinizle birlikte kullanmak için çoğu durumda API’ye gerek yoktur:

• Ürünleri mağazanızdan almak ve üretilen fotoğrafları geri göndermek için: Mağazanızı bağlama.
• Yüzlerce ürünü tek seferde üretmek ve görsel adresleri güncellenmiş dosyayı geri almak için: Excel ile toplu üretim.
• Kurumsal bir API ihtiyacınız varsa destek talebi açın (yeni sekmede açılır) ve kategori olarak Public API ve webhook’u seçin.

• Kimlik doğrulama: Her istek Authorization: Bearer sk_live_… başlığı taşır. Anahtar yalnızca bir kez gösterilir; sunucuda yalnızca özeti saklanır. Public API oturum çerezi kabul etmez.
• Yetkiler (scope): catalog:read, products:read, products:write, generations:read, generations:write, credits:read. Yetkisi olmayan çağrı INSUFFICIENT_SCOPE (403) döner.
• Idempotency: POST /v1/generations çağrısında Idempotency-Key başlığı zorunludur (en az 8 karakter). Aynı anahtarla gelen ikinci çağrı yeni iş açmaz, mevcut işi döndürür.
• Hız sınırı: pencere başına 600 istek. Her yanıtta X-RateLimit-Limit, X-RateLimit-Remaining ve X-RateLimit-Reset başlıkları vardır; aşılırsa RATE_LIMITED (429) döner.

1. 1

   Adım 1: Yükleme adresi alın

   POST /v1/uploads imzalı bir yükleme adresi döner; dosyayı bu adrese PUT ile yüklersiniz.

2. 2

   Adım 2: Ürünü oluşturun

   POST /v1/products ürünü kaydeder ve ön işlemeyi kuyruğa alır.

3. 3

   Adım 3: Manken ve poz seçin

   GET /v1/mannequins, ardından GET /v1/poses?mannequin_id=… (yalnızca o manken için hazır pozlar).

4. 4

   Adım 4: Maliyeti öğrenin

   POST /v1/generations/estimate kredi harcamadan tutarı döner.

5. 5

   Adım 5: Üretimi başlatın

   POST /v1/generations işi açar; krediler peşin ayrılır.

6. 6

   Adım 6: Sonucu alın

   Webhook geldiğinde GET /v1/generations/{id} ile taze, imzalı indirme adresini alın.

• İmza: X-Signature başlığı, <X-Timestamp>.<ham gövde> dizgisinin imzalama anahtarıyla HMAC-SHA256 özetidir. Doğrulamayı JSON’a çevirmeden, ham gövde üzerinde yapın.
• Zaman damgası: X-Timestamp değerini de kontrol edin (önerilen tolerans 5 dakika); imza tek başına yeniden oynatmayı engellemez.
• Teslimat: 2xx dışındaki her yanıt başarısız sayılır ve 24 saate kadar yeniden denenir. 50 ardışık başarısızlıktan sonra uç devre dışı kalır. Aynı olayın yeniden teslimatında id aynıdır.
• Görsel adresi gövdede gelmez: imzalı adresler kısa ömürlüdür. Olayı aldığınızda GET /v1/generations/{id} ile adresi isteyin ve saklamayın.

Hatalar her zaman aynı zarfla döner: error.code (ör. INSUFFICIENT_CREDITS), çevrilmiş bir error.message ve error.request_id. Kodunuzu code üzerinden dallandırın; mesajlar değişebilir. Destek talebinde request_id değerini paylaşın. Başka bir organizasyonun kaynağına erişim 404 döner.