Etsy API, yazılımların bir Etsy mağazasıyla çalışması için Etsy'nin resmi ve belgelenmiş yoludur: onaylı bir uygulama izninizi Etsy'nin kendi giriş ekranında ister, sonra yalnızca izin verdiğiniz şeyleri, örneğin ilanları (listing) ya da siparişleri okur veya günceller. Resmi olmayan araçlardan farkı, şifrenizi hiçbir zaman vermemeniz ve uygulamanın erişimini Etsy hesabınızdan istediğiniz an kaldırabilmenizdir.
Bunun önemli olması için kod yazmayı bilmeniz gerekmez. Etsy satıcıları için ilan hazırlayan, siparişleri eşitleyen ya da takip numarası gönderen hemen her araç, mağazanıza nasıl bağlandığına dayanır. Bu bağlantı da aracın ne kadar güvenli, istikrarlı ve geri alınabilir olduğunu belirler. Bu yazı, mağazasına hangi uygulamaları alacağına karar veren satıcılar için.
API nedir, sade bir dille
API, application programming interface, yani uygulama programlama arayüzü demektir: bir programın diğerine gönderebileceği, cevapları da önceden belirlenmiş istekler bütünü. Shop Manager'da bir insanın tek tek tıklaması yerine uygulama "şu başlık, şu etiketler ve şu fotoğraflarla bir ilan oluştur" gibi bir istek gönderir, Etsy de sonucu bildirir.
Önemli olan "belirlenmiş" kısmıdır. Hangi isteklerin var olduğuna, her birinin hangi veriyi döndürdüğüne ve hangi uygulamaların bunları kullanabileceğine Etsy karar verir. API üzerinden çalışan bir uygulama, insan gözü için yapılmış sayfaları okumak yerine her seferinde aynı düzende veri alır.
Bir uygulama nasıl bağlanır: şifre değil, izin
Uygulamalar Etsy API'ye OAuth ile bağlanır. OAuth, şifre paylaşmadan erişim vermenin standart bir yoludur. Akış her onaylı uygulamada aynıdır:
Uygulamada bağlan düğmesine tıklarsınız.
Etsy'nin kendi sitesindeki giriş ekranına yönlendirilirsiniz.
Etsy, uygulamanın hangi izinleri istediğini gösterir, örneğin ilanlarınızı okumak ya da siparişlerinizi yönetmek.
Onaylarsınız ve Etsy uygulamaya yalnızca o izinler için geçerli bir anahtar (token) verir.
Uygulama şifrenizi hiç görmez ve Etsy'nin güvenlik adımları yerinde kalır. Etsy satıcıların iki adımlı doğrulama kurmasını şart koşar (Etsy yardım sayfası) ve OAuth bağlantısı bunun etrafından dolaşmaz, onunla birlikte çalışır. Bir uygulamayı kullanmayı bıraktığınızda erişimini Etsy hesabınızdan kaldırırsınız ve anahtar çalışmaz hale gelir.
Onaylı uygulamalar API üzerinden neler yapabilir
Etsy'nin tanıdığı ve sizin onayladığınız izinler dahilinde bir uygulama mağazanın gündelik işlerinin önemli bir kısmını yürütebilir:
İlanlar: ilanları taslak (draft) olarak oluşturmak ya da yayınlamak, başlık, etiket, açıklama, fiyat ve varyasyonları güncellemek, fotoğraf ve video yüklemek.
İlanların kullandığı mağaza ayarları: yeni ilanların kullanması için kargo profillerini, iade politikalarını ve mağaza bölümlerini okumak.
Siparişler: yeni siparişleri, varyantla ve alıcının girdiği kişiselleştirme metniyle birlikte okumak.
Gönderim güncellemeleri: siparişlere takip numarası eklemek.
İlanların otomatik hazırlanmasının arkasındaki altyapı budur. Uygulama ne yaparsa yapsın Etsy'nin ilan kuralları geçerlidir: başlık en fazla 140 karakter olabilir, bir ilanda en fazla 20 fotoğraf ve 2 video bulunabilir (Etsy yardım sayfası) ve her biri en fazla 20 karakterlik 13 etikete kadar kullanabilirsiniz (Etsy yardım sayfası). API bu sınırların hiçbirini kaldırmaz.
API'nin en çok tıklama kazandırdığı yer siparişlerdir. ABD'deki satıcılar için bir siparişin tamamlanması takip bilgisi eklemeyi gerektirir (Etsy yardım sayfası). Bu yüzden takip numarası eşitlemesi bir sipariş uygulamasının en işe yarayan özelliklerinden biridir. Ayrıntılar Etsy'de takip numarası ne zaman, nasıl eklenir yazımızda.
Resmi API uygulamaları ve resmi olmayan araçlar
| Soru | Etsy API kullanan uygulama | Resmi olmayan araç |
|---|---|---|
| Nasıl bağlanır | Etsy'nin kendi giriş ekranında siz onaylarsınız | Etsy şifrenizi ister ya da oturumu açık tarayıcınız üzerinden çalışır |
| Neye erişir | Yalnızca onayladığınız izinlere | Hesabınızın erişebildiği her şeye |
| Nasıl durdurulur | Erişimini Etsy hesabınızdan kaldırırsınız | Şifrenizi değiştirir, aracı kaldırırsınız |
| Etsy bir sayfayı yenilediğinde | Etkilenmez, çünkü sayfaları okumaz | Sayfa düzeni değişince bozulabilir |
Tarayıcınızda yalnızca okumanıza ya da yazmanıza yardım eden eklentiler ayrı bir durumdur. Her araç için sorulacak soru, şifrenizi isteyip istemediği ve hesabınızda onaylamadığınız işlemler yapıp yapmadığıdır.
Bir aracın resmi API'yi kullanıp kullanmadığı nasıl anlaşılır
Bağlan düğmesi sizi aracın kendi sitesinde Etsy şifrenizi isteyen bir forma değil, etsy.com üzerindeki bir giriş ya da izin ekranına götürür.
İzin ekranı uygulamanın ne yapmak istediğini listeler.
Araç Etsy API'yi kullandığını açıkça söyler.
Bağlandıktan sonra erişimini Etsy hesabınızdan kaldırabilirsiniz.
Alomations Etsy'ye nasıl bağlanır
Alomations resmi Etsy API üzerinden bağlanır. Bağlantıyı Etsy'nin kendi giriş ekranında onaylarsınız, işlem iki dakikadan kısa sürer ve bağlantıyı dilediğiniz zaman Etsy'den iptal edebilirsiniz. Alomations, Etsy'ye bağlı bir kuruluş değildir ve Etsy, Inc. tarafından onaylanmış ya da sertifikalandırılmış değildir.
Bu bağlantı üzerinden Alomations:
ilanları mağazanızda başlık, 13 etiket, açıklama, varyasyonlar ve fiyatlar yerinde olarak, çalıştırmadaki tek bir ayara göre canlı ya da Etsy taslağı olarak yayınlar
şablonlar için kargo, iade ve hazırlık profillerinizi okur, siz değiştirdiğinizde Refresh from Etsy ile günceller
siparişleri tasarım ve varyant eşleşmiş, alıcının kişiselleştirmesi ekli olarak getirir
Etsy'nin izin verdiği durumlarda takip numarasını Etsy'ye geri gönderir
İlan yöneticisi de bağlı her mağazanın aktif ve taslak ilanlarını tek listede gösterir. Ekranları adım adım görmek için Etsy mağazanızı Alomations'a iki dakikada bağlamak, daha geniş bir bakış için Etsy entegrasyonu ile neler otomatikleştirilebilir yazımıza bakabilirsiniz.
Sık sorulan sorular
Etsy API'yi kullanmak için kod bilmem gerekir mi?
Hayır. API üzerine kurulu uygulamalar istekleri kendileri gönderir. Sizin yapmanız gereken yalnızca bağlantıyı Etsy'nin ekranında onaylamaktır.
API ile bağlanan bir uygulama Etsy şifremi görür mü?
Hayır. Girişi Etsy'nin kendi ekranında yaparsınız ve uygulama şifrenizi değil, yalnızca onayladığınız izinler için geçerli bir anahtar alır.
Bir uygulamanın mağazamla bağlantısını nasıl keserim?
Erişimini Etsy hesabınızdan kaldırın, uygulamanın içinden de bağlantıyı kesin. Erişim kaldırıldıktan sonra uygulama mağazanızda işlem yapamaz.
Etsy API kullanan bir araç Etsy tarafından onaylanmış mı demektir?
Hayır. API'yi kullanmak, Etsy'nin aracı desteklediği anlamına gelmez. Örneğin Alomations resmi API'yi kullanır, ama Etsy, Inc. tarafından onaylanmış ya da sertifikalandırılmış değildir.
Mağazanızı resmi API üzerinden bağlayıp ilk çalıştırmanızı Alomations ücretsiz planında deneyebilirsiniz.