Durum kodları
| Kod | Etsy şemasındaki anlamı | İlk kontrol |
|---|---|---|
| 400 | İstek verisinde sorun var | Zorunlu alanlar, değer biçimi |
| 401 | Geçerli kimlik bilgisi yok | x-api-key ve Bearer token |
| 403 | İşleme izin verilmiyor | Kapsam, ilan durumu, uç kısıtı |
| 404 | Kaynak bulunamadı | shop_id, listing_id, receipt_id |
| 409 | Kaynağın mevcut durumuyla çakışma | İlan durumu, varyasyon sayısı |
| 422 | İstek işlenemedi | Envanter okumada görülebilir |
| 429 | Sınır aşıldı | retry-after kadar bekleyin |
| 500, 503 | Etsy tarafında hata ya da hizmet yok | Bekleyip tekrar deneyin |
Hata gövdesi nasıl okunur?
Etsy şemasındaki hata gövdesi tek bir error alanı taşır. OAuth uçları RFC 6749'daki gibi error ve error_description döndürür. Canlı kullanımda ilan doğrulama hatalarının ise tek bir error metni yerine path ve message alanlarından oluşan bir liste olarak geldiği görüldü.
Bu yüzden hata okuyan kod üç biçimi de denemeli: liste ise her öğenin path ve message değerini birleştirin, değilse error_description ya da error alanını alın. Aksi halde gerçek neden "Request failed" gibi genel bir mesajın arkasında kaybolur.
Canlıda görülen mesajlar
| Mesaj ya da durum | Neden | Çözüm |
|---|---|---|
| quantity için "cannot be empty" | Adet 0 gönderildi ya da sold_out ilan PATCH edildi | Stok bitince ilanı pasife alın; sold_out ilan panelden yenilenir |
| "Expected float value for 'price'" | Envanter PUT isteğinde bir teklifin fiyatı boş | Mevcut fiyatı okuyup her teklife aynen yazın |
| "All offerings need readiness state" | Tekliflerde readiness_state_id eksik | Okunan değeri her teklife geri gönderin |
| "Cannot deactivate a listing in this state" | Taslak ilan pasife alınmak istendi | Taslak zaten yayında değildir; işlem gerekmez |
| 403 ve "is removed" | İlan Etsy'de kaldırılmış | Kaydı arşivleyin; bu ilan düzenlenemez |
| "refresh_token is invalid" | Eski yenileme token'ı | En son saklanan token'ı kullanın ya da yeniden yetkilendirin |
| "Exceeded daily rate limit" | Günlük kota doldu | İstek sayısını azaltın, retry-after'a uyun |
Belgelenmiş özel durumlar
- Üç varyasyonlu bir ilanın envanteri max_variations_supported=3 parametresi olmadan güncellenirse Etsy 409 döner.
- Kargo takip ucu yalnız Etsy'nin onayladığı uygulamalara açıktır; onaysız uygulamaya doğru kapsamla bile 403 ve "Unauthorized" döner.
- Fiziksel ilanı dijitale çevirirken ilanın birden fazla ürünü varsa updateListing 409 döner; önce envanter tek ürüne indirilir.
- Bir ilan iki etkin videoya ulaştığında yeni video yüklemesi 409 alır.
Sık sorulanlar
Etsy API 403 hatası neden olur?
En sık neden token'da gereken kapsamın olmamasıdır. Kaldırılmış bir ilanı düzenlemek ya da onay gerektiren kargo takip ucunu çağırmak da 403 verir.
Etsy 409 Conflict ne demek?
İstek, kaynağın mevcut durumuyla çakışıyor demektir. Varyasyon sayısı, ilan türü ya da video sınırı gibi durum kurallarını kontrol edin.
Etsy hata mesajı neden "Request failed" olarak görünüyor?
Doğrulama hataları liste biçiminde gelebilir. Kodunuz yalnız error alanına bakıyorsa mesajı göremez; listedeki path ve message değerlerini okuyun.
Kaynaklar
İlgili Etsy API konuları
Son güncelleme: 27.10.2026 · Etsy API rehberinin tamamı