Hata Yanıtları#

HTTP durumu	Anlamı	Önerilen eylem
`400 Bad Request`	İstek gövdesi veya sorgu parametreleri geçersiz.	Yeniden denemeden önce isteği düzeltin.
`401 Unauthorized`	Kimlik bilgileri eksik, geçersiz, süresi dolmuş veya etkin değil.	Kimlik doğrulama başlıklarını doğrulayın veya Ideal House ile iletişime geçin.
`403 Forbidden`	İstekteki `shopId`, kimlik bilgileriyle ilişkili değildir.	Bu kimlik bilgilerine atanmış Shop ID değerini kullanın.
`404 Not Found`	İçe aktarma durumu veya eşleşen ürün bulunamadı.	Shop ID ile istenen ürün kimliğini veya SKU değerini doğrulayın.
`409 Conflict`	Mağaza için başka bir içe aktarma işi etkin.	Geçerli içe aktarma işinin bitmesini bekleyin.
`429 Too Many Requests`	İstek sıklığı çok yüksek.	Bekleme süresini üstel olarak artırıp rastgele bir ek gecikme uygulayarak yeniden deneyin.
`500 Internal Server Error`	Hizmet beklenmeyen bir hatayla karşılaştı.	Bekleme süresini üstel olarak artırarak yeniden deneyin. Hata devam ederse Ideal House ile iletişime geçin.
`502 Bad Gateway` veya `503 Service Unavailable`	API geçici olarak kullanılamıyor.	Bekleme süresini üstel olarak artırarak yeniden deneyin.

Bir doğrulama hatası aşağıdaki biçimi kullanabilir:

json

{
  "message": ["shopId should not be empty"],
  "error": "Bad Request",
  "statusCode": 400
}

message alanındaki metin değişebilir. Program mantığında HTTP durum kodunu ve belgelenmiş yanıt alanlarını kullanın.

Yeniden Deneme ve Kurtarma Kılavuzu#

İş pending veya running durumundayken her 2 ila 5 saniyede bir durumu sorgulayın.
429, 500, 502 ve 503 yanıtlarında bekleme süresini üstel olarak artırın, rastgele bir ek gecikme uygulayın ve yeniden deneme sayısına üst sınır koyun.
İsteği veya kimlik bilgilerini düzeltmeden, 400, 401 veya 403 yanıtı dönen istekleri otomatik olarak yeniden denemeyin.
409 yanıtından sonra etkin işin durumunun completed veya failed olmasını bekleyin.
Bir yanıt almadan önce gönderim zaman aşımına uğrarsa toplu işlemi tekrar göndermeden önce durum uç noktasını sorgulayın.
İçe aktarma işlemleri oluşturma veya güncelleme davranışını kullandığından, aynı ürünü aynı SKU ile yeniden denemek güvenlidir.
Ürün düzeyinde hatalarla tamamlanan bir işten sonra yalnızca işlenmesi başarısız olan ürünleri içeren yeni bir grup gönderin.
İş düzeyindeki bir hatadan sonra successCount içinde sayılan ürünler zaten güncellenmiş olabilir. İlk gönderilen grubu aynı SKU değerleriyle yeniden göndermek güvenlidir.
İstek 503 döndürse bile silme işlemi zaten gerçekleşmiş olabilir. Aynı silme isteğini tekrarlamak güvenlidir.

Durum uç noktası kalıcı bir içe aktarma geçmişi tutmak için değil, etkin veya en son işi izlemek için tasarlanmıştır. Veri mutabakatı ve destek amacıyla gönderdiğiniz ürün grubunu, jobId değerini, durum yanıtlarını ve nihai sonucu kendi sisteminizde saklayın.

Canlıya Geçiş Kontrol Listesi#

Client Secret değerini bir gizli bilgi yöneticisinde veya korumalı sunucu ortamında saklayın.
Her ürün için istikrarlı, benzersiz bir SKU kullanın.
İstek başına 500'den fazla ürün göndermeyin.
Görsellerin URL adreslerinin herkese açık olduğundan ve işleme boyunca erişilebilir kaldığından emin olun.
processImages: true değerini yalnızca görüntü ön işleme gerektiğinde ve görüntü başına 1 kredilik işleme ücreti kabul edildiğinde açıkça ayarlayın. Aksi halde alanı atlayın veya false olarak ayarlayın.
Zemin görsellerini bölme özelliğini yalnızca hem processImages hem de processFloorImages değerini true yaparak etkinleştirin.
Her ürün için name, imageUrl, productUrl, width, height ve desteklenen bir productType değeri sağlayın.
status alanını belirtiyorsanız değerini active, inactive, out_of_stock veya invalid olarak ayarlayın.
Boyutları desteklenen bir birimle pozitif değerler olarak gönderin veya inç kullanmak için birimi atlayın; saklanan değerler inçe dönüştürülür.
Döndürülen jobId değerini kalıcı olarak kaydedin ve sonraki durum yanıtlarıyla karşılaştırın.
failedCount > 0 olan completed durumunu kısmi başarı olarak değerlendirin.
Sınırsız bir katalog istemek yerine ürün listesini sayfalara ayırın.
Silme işlemleri için productId veya sku tanımlayıcılarından tam olarak birini sağlayın.
Yeniden deneme sayısını sınırlayın; bekleme süresini üstel olarak artırın ve rastgele bir ek gecikme uygulayın.

Kimlik bilgileri, ilk kurulumda sağlanan değerler, ürün türü eşlemesi veya devam eden entegrasyon sorunları için Ideal House entegrasyon temsilcinizle iletişime geçin.