Kimlik doğrulama
Her v3 isteğinde x-api-key başlığı bulunur: keystring ve shared secret, aralarında iki nokta ile. Mağaza verisi okuyan ya da yazan uçlar ek olarak Authorization: Bearer başlığında OAuth 2.0 erişim token'ı ister. Erişim token'ı 1 saat, yenileme token'ı 90 gün geçerlidir. Ayrıntılar: API anahtarı, OAuth ve PKCE ve token yenileme.
Temel adres ve sürüm
| Adres | Ne için |
|---|---|
| https://api.etsy.com/v3/application/ | Tüm API kaynakları; openapi.etsy.com eşdeğeridir |
| https://www.etsy.com/oauth/connect | Satıcının izin verdiği sayfa |
| https://api.etsy.com/v3/public/oauth/token | Token alma ve yenileme |
Tüm iletişim UTF-8 ve HTTPS ile yapılır. v2 dönemindeki OAuth 1.0 token'ları v3'te çalışmaz; Etsy bunlar için token_exchange adlı bir dönüştürme akışı sunar.
İstek sınırları ve sayfalama
Etsy sınırları API anahtarı başına saniyelik (QPS) ve günlük (QPD) olarak uygular; günlük sınır kayan 24 saatlik pencereyle hesaplanır. Uygulamanızın güncel sınırları geliştirici portalında görünür. Sınır aşılınca 429 ve retry-after başlığı döner. Liste uçları limit ve offset kullanır: varsayılan 25, en fazla 100 kayıt; offset en fazla 12000 olabilir. Ayrıntı: istek sınırları ve sayfalama.
Genel hata kodları
| Kod | Etsy'deki anlamı |
|---|---|
| 400 | İstek verisinde sorun; doğrulama hataları alan bazında döner |
| 401 | Geçerli kimlik bilgisi yok: x-api-key ya da Bearer token eksik veya hatalı |
| 403 | İşleme izin yok: kapsam eksik, ilan kaldırılmış ya da uç kısıtlı |
| 404 | Kaynak bulunamadı |
| 409 | Kaynağın mevcut durumuyla çakışma |
| 429 | Saniyelik ya da günlük sınır aşıldı |
| 500 | Etsy tarafında iç hata |
Hata gövdesi çoğunlukla error alanı taşır. Tüm durumlar ve canlıda görülen mesajlar hata kodları sayfasında.
Etsy API işlemleri
Genel
Ürün ve ilan
Stok ve fiyat
Sipariş
Sık sorulanlar
Etsy webhook gönderir mi?
Evet. Etsy sipariş, ilan ve envanter olayları için imzalı webhook bildirimleri sunar; ör. order.paid ve inventory.out_of_stock. Saystok Etsy için webhook kullanmaz, siparişleri düzenli aralıkla okur.
Etsy API için hangi bilgiler gerekir?
Uygulamanın keystring ve shared secret değerleri, satıcının OAuth ile verdiği izinden gelen token'lar ve mağazanın shop_id değeri. Saystok bağlantısında bunlar Client ID, Client Secret, Refresh Token ve Shop ID olarak girilir.
Etsy stok adedini 0 yapabilir miyim?
Etsy ilan ve envanter uçları pozitif adet ister; canlı kullanımda 0 adet reddedildi. Stok bittiğinde ilan pasife alınır. Ayrıntılar stok ve fiyat güncelleme sayfasında.
Etsy siparişleri Saystok'a ne sıklıkla gelir?
Saystok Etsy siparişlerini 5 dakikada bir okur ve satılan adedi diğer kanallardan düşer. Etsy ilan listesi ise istek kotasını korumak için 6 saatte bir okunur.