Yeni: wwidgets API İçin Geliştirici Sayfası Yayında

wwidgets API'si için yeni bir geliştirici sayfası yayınladık. Sayfada REST API'nin nasıl çalıştığını cURL, JavaScript, PHP ve Python örnekleriyle anlatıyor, sorularına cevap bulmanı kolaylaştıran bir soru-cevap yardımcısı sunuyor ve gerçek siparişleri API anahtarı olmadan bildirime dönüştüren satış webhook'unu adım adım gösteriyoruz. Sayfaya wwidgets geliştiriciler sayfasından ulaşabilirsin.

Geliştirici sayfasını neden hazırladık?

wwidgets'ı kullanan mağazaların ve ajansların önemli bir kısmı, işin bir noktasında panelin ötesine geçmek istiyor. Bir ajans onlarca müşterisinin kampanyalarını tek tek açıp kapatmak yerine bunu kendi sisteminden yapmak istiyor. Bir mağaza, widget istatistiklerini her hafta elle kopyalamak yerine kendi raporuna otomatik çekmek istiyor. Bir geliştirici de son satışlar bildirimini kendi sipariş altyapısına bağlamanın en kısa yolunu arıyor.

Bu ihtiyaçların cevabı API'de zaten vardı; eksik olan, hepsini bir arada, anlaşılır biçimde anlatan bir kaynaktı. Yeni geliştirici sayfası tam olarak bunu yapıyor: neyin mümkün olduğunu, nasıl başlayacağını ve hangi sınırlar içinde çalışacağını tek bir yerde topluyor.

Geliştirici sayfasında neler var?

REST API rehberi

wwidgets REST API'si üç temel alanı kapsıyor: kampanyalar, widget'lar ve istatistikler. Sayfada her alanın ne işe yaradığını, isteklerin nasıl yapılandırıldığını ve yanıtların nasıl okunacağını sade bir dille anlatıyoruz. Amacımız, API ile ilk kez çalışan birinin de birkaç dakika içinde ilk isteğini gönderebilmesi.

Dört dilde kod örnekleri

Her örneği cURL, JavaScript, PHP ve Python ile hazırladık. Böylece komut satırından hızlıca bir şey denemek isteyen de, WordPress eklentisi yazan PHP geliştiricisi de, raporlama betiği hazırlayan Python kullanıcısı da kendi diline uygun örneği kopyalayıp doğrudan kullanmaya başlayabilir. Örnekler kısa ve tek bir işi yapacak şekilde yazıldı; kendi projene uyarlaması kolay.

Soru-cevap yardımcısı

Dokümantasyonun tamamını okumadan belirli bir soruya cevap bulmak isteyenler için sayfada bir soru-cevap yardımcısı var. "İstatistikleri belirli bir tarih aralığı için nasıl çekerim?" ya da "Bir widget'ı API üzerinden nasıl kapatırım?" gibi sık karşılaşılan soruların cevaplarına hızla ulaşabilirsin.

Satış webhook'u: API anahtarı gerekmeden gerçek siparişler

Sayfanın belki de en pratik bölümü bu. Son satışlar widget'ı, gerçek siparişleri bir webhook üzerinden alabiliyor. Bunun için API anahtarına ihtiyacın yok; widget'ın sana verdiği webhook adresini mağazanın sipariş bildirim ayarına eklemen yeterli. Örneğin WooCommerce'te ödeme tamamlandığında tetiklenen kancayı bu adrese yönlendirdiğinde, her yeni sipariş sitende "İstanbul'dan Ayşe az önce bir ürün satın aldı" gibi gerçek bir bildirime dönüşür.

Bu yöntem, sosyal kanıtın en önemli şartını da kendiliğinden sağlar: gösterilen her satış gerçektir. Uydurma bildirim kullanmaya gerek kalmaz.

API ile neler yapabilirsin?

Geliştirici sayfasında yer alan örneklerden yola çıkarak kurabileceğin bazı senaryolar:

• Kampanyaları senkronize etmek: Birden fazla site yöneten bir ajans, müşteri kampanyalarını kendi panelinden ya da proje yönetim sisteminden takip edebilir.
• Widget'ları takvime göre açıp kapatmak: Black Friday kampanyası cuma sabahı başlayıp pazar gece bitiyorsa, geri sayım ve kupon widget'larını zamanlanmış bir görevle otomatik olarak açıp kapatabilirsin. Kampanya bittiği halde açık kalan bir indirim duyurusu derdi ortadan kalkar.
• Haftalık istatistikleri panoya çekmek: Gösterim, tıklama, tıklama oranı, form gönderimi ve dönüşüm oranı verilerini her pazartesi kendi raporlama tablona ya da panona aktarabilirsin. Böylece widget performansını satış verilerinle yan yana görebilirsin.
• WooCommerce ve Shopify siparişlerini aktarmak: Satış webhook'u ile mağazandaki siparişleri son satışlar bildirimine göndermek. WooCommerce için ödeme tamamlandı kancası, Shopify için sipariş bildirimleri bu iş için kullanılabilir.

Bilmen gereken sınırlar ve koşullar

Dakikada 60 istek sınırı, kampanya senkronizasyonu, zamanlanmış açma kapama ve günlük ya da haftalık istatistik çekme gibi tipik kullanımlar için fazlasıyla yeterli. Çok sayıda siteyi aynı anda yönetiyorsan isteklerini sıraya koyup aralıklı göndermen iyi bir uygulama olur.

Nasıl başlarsın?

1. Henüz hesabın yoksa ücretsiz deneme hesabı aç. Deneme süresince API erişimi de açık.
2. Panelde Hesap → API bölümüne git ve API anahtarını oluştur.
3. Anahtarını güvenli bir yerde sakla. Tarayıcıda çalışan herkese açık kodlara yazma; sunucu tarafında, ortam değişkeni gibi bir yöntemle kullan.
4. Geliştirici sayfasındaki örneklerden birini kendi dilinde seç ve ilk isteğini gönder.
5. Son satışlar bildirimini kuracaksan widget ayarlarındaki webhook adresini kopyala ve mağazanın sipariş bildirimlerine ekle.

Widget'ları sitene nasıl ekleyeceğini henüz bilmiyorsan, önce başlangıç rehberine göz at. Tek satırlık piksel kodunu sitenin <head> bölümüne ekledikten sonra API ile yönettiğin her değişiklik sitene otomatik yansır.

Örnek senaryo: bir kampanya haftasını otomatikleştirmek

Diyelim ki Eskişehir'de ev tekstili satan bir WooCommerce mağazan var ve kasım sonunda dört günlük bir indirim planlıyorsun. API ve satış webhook'u ile bu haftayı şöyle kurgulayabilirsin:

1. Hazırlık: Kampanyadan birkaç gün önce panelde geri sayım sayacını ve kupon barını hazırlarsın, ama kapalı tutarsın.
2. Başlangıç: Perşembe gece yarısı çalışan zamanlanmış bir betik, API üzerinden bu iki widget'ı açar. Sabah erkenden panele girip elle açmayı hatırlaman gerekmez.
3. Kampanya süresince: Satış webhook'u, mağazanda ödemesi tamamlanan her siparişi son satışlar bildirimine aktarır. Ziyaretçiler, kampanyaya gerçekten katılan müşterileri görür.
4. Bitiş: Pazar gece 23.59'da aynı betik widget'ları kapatır. Süresi dolmuş bir indirimi duyuran bar sitede kalmaz.
5. Değerlendirme: Pazartesi sabahı başka bir betik, kampanya haftasının gösterim, tıklama ve dönüşüm verilerini çekip raporuna ekler. Bu verileri mağazanın satış rakamlarıyla yan yana koyarak hangi widget'ın işe yaradığını görürsün.

Bu kurguda yaptığın tek elle iş, widget'ları baştan hazırlamak. Gerisi, geliştirici sayfasındaki örneklerden uyarlanan birkaç kısa betikle yürür.

API kullanırken dikkat etmen gerekenler

• Anahtarını gizli tut: API anahtarını herkese açık bir depoya, tema dosyasına ya da tarayıcıda çalışan koda koyma. Bir anahtarın ele geçtiğinden şüphelenirsen yenisini oluştur.
• Önce test et: Gerçek kampanyalarını etkileyecek bir betiği çalıştırmadan önce deneme amaçlı bir kampanya üzerinde dene.
• Gereksiz istekten kaçın: İstatistikleri her dakika değil, ihtiyacın kadar sık çek. Günlük ya da haftalık raporlar için bu fazlasıyla yeterli.

Kimler için faydalı?

• Ajanslar: Birden fazla müşterinin widget'larını tek bir yerden yönetmek ve raporlamak isteyenler.
• Kendi altyapısını kullanan mağazalar: Özel bir sipariş sistemi olan ve siparişleri son satışlar bildirimine bağlamak isteyenler.
• Veriyle çalışan ekipler: Widget performansını satış ve trafik verileriyle aynı panoda görmek isteyenler.
• Eklenti ve tema geliştiricileri: wwidgets'ı kendi çözümlerine entegre etmek isteyenler.

Müşterileri için wwidgets kuran bir ajans ya da danışmansan, API ile kurduğun otomasyonların yanında partner programımıza da göz atmanı öneririz. Yönlendirdiğin müşterilerin her ödemesinden, yenilemeler dahil %20 komisyon kazanırsın. Böylece kurduğun entegrasyonlar hem müşterine hem de sana kalıcı bir değer üretir.

Sıkça sorulan sorular

API'yi Professional planında kullanabilir miyim?

API erişimi E-Commerce World planına dahil. 14 günlük ücretsiz deneme süresince de kullanabilirsin; böylece plan seçmeden önce entegrasyonunu test etme fırsatın olur.

Satış webhook'unu kullanmak için kod yazmam gerekir mi?

Çoğu durumda hayır. Mağaza platformun sipariş bildirimlerini bir adrese göndermeyi destekliyorsa, webhook adresini oraya eklemen yeterli. Özel bir sistem kullanıyorsan küçük bir entegrasyon gerekebilir; geliştirici sayfasındaki örnekler bunun için hazırlandı.

Dakikada 60 istek sınırını aşarsam ne olur?

Sınırı aşan istekler kabul edilmeyebilir. Bunu önlemek için isteklerini aralıklı gönder, birden fazla siteyi yönetiyorsan sıraya koy ve başarısız bir isteği kısa bir beklemeden sonra tekrar dene.

Yeni geliştirici sayfası, wwidgets'ı kendi sistemlerine bağlamak isteyen herkesin işini kısaltmak için hazırlandı. Örnekleri incele, ilk isteğini gönder ve aklına takılan bir şey olursa soru-cevap yardımcısını kullan. Henüz hesabın yoksa 14 günlük ücretsiz denemeyle hemen başlayabilirsin.