Etsy'deki kapsamlar
Etsy belgesi şu kapsamları listeler ve listenin değişebileceğini belirtir (Etsy: Authentication):
| Kapsam | Ne sağlar |
|---|---|
| listings_r | Pasif ve süresi dolmuş, yani herkese açık olmayan ilanları okuma |
| listings_w | İlan oluşturma ve düzenleme |
| listings_d | İlan silme |
| transactions_r | Alış ve satış verisini okuma |
| transactions_w | Satış verisini güncelleme |
| shops_r | Mağaza açıklaması, mesajları ve bölümlerini okuma |
| shops_w | Mağaza bilgilerini güncelleme |
| address_r, address_w | Teslimat adreslerini okuma, güncelleme ve silme |
| email_r | Kullanıcı profilini okuma |
| profile_r, profile_w | Özel profil bilgisini okuma ve güncelleme |
İşleme göre gereken izin
Her ucun istediği kapsam Etsy'nin API başvurusunda yazar. Bir entegrasyonun en sık kullandığı uçlar şunlardır:
| İşlem | Uç | Kapsam |
|---|---|---|
| Mağaza ilanlarını listeleme | GET /v3/application/shops/{shop_id}/listings | listings_r |
| Taslak ilan açma, ilan güncelleme | POST ve PATCH .../shops/{shop_id}/listings | listings_w |
| Envanter okuma ve stok yazma | GET ve PUT /v3/application/listings/{listing_id}/inventory | listings_r, listings_w |
| İlan silme | DELETE /v3/application/listings/{listing_id} | listings_d |
| Siparişleri okuma | GET .../shops/{shop_id}/receipts | transactions_r |
| Kargo takip bilgisi gönderme | POST .../receipts/{receipt_id}/tracking | transactions_w |
| Kendi kullanıcı ve mağaza kimliği | GET /v3/application/users/me | shops_r |
| Kargo ve işlem profili okuma | GET .../shipping-profiles, .../readiness-state-definitions | shops_r |
| Kargo ya da işlem profili oluşturma | POST aynı uçlar | shops_w |
Mağaza bilgisi, kategori ağacı ve ilan görselleri gibi bazı uçlar herkese açıktır; yalnız x-api-key ister.
Neden yalnız gereken izni istemeli?
Etsy, gereğinden fazla izin isteyen uygulamaları kullanıcıların onaylamaya daha az istekli olduğunu belirtir. Ayrıca izin listesini sonradan genişletmek kolay değildir: yenileme token'ı ilk izindeki kapsamı taşır ve değiştirilemez. Yeni kapsam için satıcı izin sayfasından yeniden geçer.
Token yanıtındaki scope alanı, gerçekte verilen izinleri gösterir ve istenenden az olabilir. Elinizdeki token'ın izinlerini görmek için Etsy'nin POST /v3/application/scopes ucuna token'ı gönderebilirsiniz.
Sık hatalar ve çözümleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Sipariş ucu 403 | Token'da transactions_r yok | Akışı bu kapsamla yeniden yapın |
| İlan silme 403 | listings_d istenmemiş | Silme gerekiyorsa listings_d ekleyin |
| İşlem profili oluşturma başarısız | shops_w yok | Profili Etsy panelinden açın ya da shops_w isteyin |
| Kargo takip ucu 403 "Unauthorized" | Uç, Etsy onayı gerektiriyor | Kapsam yetmez; Etsy'ye başvurun |
| Siparişte alıcı e-postası boş | Erişim ayrıca onay gerektiriyor | Commercial Access uygulamaları bu alanı ayrıca ister |
Sık sorulanlar
Etsy stok güncellemek için hangi scope gerekir?
listings_w. Envanteri önce okumak için listings_r de gerekir. Stok, ilanın envanter ucuna PUT isteğiyle yazılır.
Etsy siparişlerini okumak için hangi izin gerekir?
transactions_r. Siparişlere kargo takip bilgisi eklemek ise transactions_w ister ve Etsy'nin ayrıca onay verdiği uygulamalara açıktır.
Token'a sonradan izin ekleyebilir miyim?
Hayır. Yenileme token'ı ilk kapsamı korur. Yeni izin için yetkilendirme akışını genişletilmiş scope listesiyle yeniden başlatın.
Token'ımın hangi izinleri taşıdığını nasıl görürüm?
Token yanıtındaki scope alanına bakın ya da token'ı POST /v3/application/scopes ucuna gönderin. Uç, verilen kapsamları listeler.
Kaynaklar
İlgili Etsy API konuları
Son güncelleme: 27.10.2026 · Etsy API rehberinin tamamı