Sorun giderme

401 missing-credentials

• Header server-side request'e ekleniyor mu?
• Environment variable doğru deployment ortamında mı?
• Değişken public/client yerine server runtime'da mı okunuyor?

401 invalid-credentials

• Baş/son boşlukları temizleyin.
• Anahtarın tamamının secret manager'a kaydedildiğini doğrulayın.
• Kaybedilmiş/kısaltılmış anahtarı kurtarmaya çalışmayın; rotate edin.
• keyId paylaşılabilir, secret paylaşılmaz.

403 insufficient-scope

Problem içindeki requiredScope değerini kontrol edin. Yanlış uygulamaya geniş scope vermek yerine doğru amaç için ayrı anahtar oluşturun.

403 service-disabled

Scope bulunsa da servis anahtar config'inde kapalı olabilir. Admin panelde ilgili servisin enabled durumunu kontrol edin.

413 payload-too-large

Dosya byte boyutuna ek olarak piksel, wardrobe, candidate veya sonuç limitleri aşılmış olabilir. Problem details details alanını teknik logda requestId ile inceleyin; kullanıcıya güvenli sınır mesajı gösterin.

415 unsupported-media-type

Dosya uzantısı veya browser MIME değerine güvenmeyin. İçerik gerçekten JPEG/PNG/WebP olmalı; magic byte kontrol edilir.

429

• rate-limit-exceeded: Retry-After kadar bekleyin.
• quota-exceeded: quotaResetAt UTC zamanına kadar çağrıyı durdurun.

Retry döngüsünde üst sınır ve jitter kullanın.

502 / 503

Sınırlı backoff ile tekrar deneyin. Sürekli hata halinde circuit breaker uygulayın ve requestId, keyId, endpoint, UTC zaman ve HTTP status ile destek talebi açın.

422 generation-failed

Look Engine servisi çalışıyor ancak gardırop/filtre isteği karşılayamıyor. engineCode değerini kullanıcıya eyleme dönük mesajla eşleyin; sistem arızası gibi sonsuz retry yapmayın.

Taxonomy broken: true

Bu HTTP hatası değildir. Tahmin alanlarını kaydetmeden kullanıcıdan daha iyi bir fotoğraf isteyin.

Destek talebinde gönderilecekler

requestId, keyId, endpoint, HTTP status, problem type, UTC zaman,
istemde kullanılan limitlerin özeti (gizli payload olmadan)

Gönderilmeyecekler:

API secret, Authorization header, görsel/base64, tam gardırop veya kullanıcı profili