SMM Panel API ve Bayilik: API v2 ile Bayilere Satış

Bu bölümde neler var

• Standart SMM API v2'nin ne olduğu ve neden her bayinin onu zaten bildiği.
• Müşteri API'nizdeki komutlar ve bayinin her biriyle ne yaptığı.
• API doküman sayfanızı sunmak, anahtarları yönetmek ve istek limitlerini anlatmak.
• Marjınızı eritmeden bayi fiyatı belirlemek.
• Düz API erişimi yerine ne zaman child panel (alt panel) sunmanız gerektiği.
• Aynı API'nin sizi kendi sağlayıcılarınıza nasıl bağladığı ve o tarafta nelere dikkat etmeniz gerektiği.

Aynı API'nin iki yüzü

SMM panel bir zincirin ortasında durur. Yukarı yönde paneliniz, sağlayıcılarınızın müşterisidir; onların API'sine sipariş verir. Aşağı yönde ise paneliniz bir sağlayıcı olabilir; bayiler sizin API'nize sipariş verir. İki taraf da aynı dili, standart SMM API v2'yi konuşur. Paneller bu yüzden birbirine bu kadar kolay bağlanır.

Bunu kavramak, bayileriniz gibi düşünmenizi sağlar: kötü bir sağlayıcıda sizi neler sinirlendiriyorsa (belirsiz hatalar, habersiz kesintiler, ani zamlar) bayilerinizi de sizde aynı şeyler sinirlendirir.

Müşteri API v2 nedir?

Her SMMFor paneli standart API v2'yi POST https://panelim.com/api/v2 adresinde sunar. İstekler müşterinin API anahtarını ve bir action (komut) içerir. Bu biçim SMM panellerde fiilî standart olduğu için bayi, sizi kendi panel scriptine ya da botuna ek kod yazmadan "sağlayıcı" olarak ekleyebilir.

Komutlar

Bayilerin sorduğu ve bilmeniz gereken birkaç ayrıntı:

• services içindeki rate, o müşterinin indirimler dahil kendi 1.000 adet fiyatıdır.
• Sağlayıcı isimleri servis ve kategori adlarından temizlenir; kaynaklarınız gizli kalır.
• API'deki tutarlar, vitrininizde TL gösterseniz bile her zaman USD'dir. Bayilerinize bunu baştan söyleyin.
• Durumlar standart Pending, In progress, Completed, Partial, Canceled değerleridir; charge iadeler düşülmüş tutardır, bu yüzden bayinin scripti kısmi siparişleri doğru işler.
• Bayiler status sorgulamak yerine, sipariş durumu değiştiğinde tetiklenen imzalı webhook adresleri tanımlayabilir.

Tüm parametreler, servis türleri ve hata mesajları API dokümanında yer alır. Genel bakış için API özellik sayfasına bakabilirsiniz.

API doküman sayfanız

Panelinizin API doküman sayfası, bayinin bağlanmaya karar vermeden önce okuduğu sayfadır. Onu teknik alıcılar için bir satış sayfası gibi düşünün. Şunlardan emin olun:

• Endpoint adresi kalıcı alan adınızı kullanıyor. Alt alan adından kendi alan adınıza geçecekseniz mevcut bayilere önceden haber verin.
• Örnek istekler kolayca kopyalanabiliyor.
• Servis listeniz temiz: anlaşılır isimler, dürüst min ve max, doğru refill ve iptal bilgisi. Bayiler bu bilgileri doğrudan kendi panellerine aktarır.
• Kısa bir notta API sorunları için destek kanalınız ve destek saatleriniz yazıyor.

API sayfasını sitenizin menüsüne ve alt bilgisine ekleyin. Pek çok bayi fiyatlardan önce "API" bağlantısını arar.

API anahtarları

Her müşteri kendi anahtarını kendi panelinden oluşturur (SMMFor'da API ve Bayilik bölümünden, müşteri başına en fazla 5 aktif anahtar). Bayilerinize şunları önerin:

• Her entegrasyon için ayrı anahtar. Örneğin biri panel, biri Telegram botu için. Sızan anahtar her şeyi bozmadan iptal edilir.
• Anahtar yenileme. Bir yazılımcıyla yollar ayrıldığında ya da sunucu ele geçirildiğinde anahtarı yenileyin.
• Anahtarı paylaşmamak. Ekran görüntüsünde ya da destek yazışmasında anahtar görünmesin. Talebe anahtar yapıştıran olursa hemen yenilemesini söyleyin.

Sizin açınızdan bir API anahtarı, müşterinin bakiyesine erişim demektir. "Anahtarımı sıfırlar mısınız" isteğine şifre sıfırlama kadar dikkatle yaklaşın; isteyenin gerçekten hesap sahibi olduğundan emin olun.

İstek limitleri

İstek limitleri, panelinizi ve sağlayıcılarınızı kontrolden çıkmış scriptlerden korur. SMMFor'da müşteri API'si 60 saniyelik pencerede IP başına 120, anahtar başına 180 isteğe izin verir. Aşıldığında API, Retry-After başlığıyla HTTP 429 döndürür.

Bayilerin çoğu bu sınıra hiç yaklaşmaz. Yaklaşanlar genellikle her siparişin durumunu tek tek sorgulayanlardır. Böyle bir durumda engellemek yerine yardım edin:

1. Tekli sorgu yerine toplu durum sorgusunu (orders=1,2,3, istek başına 100'e kadar) önerin.
2. Webhook önerin; durum değiştiğinde haber alır, hiç sorgulamasına gerek kalmaz.
3. services listesinin bir dakika önbellekte tutulduğunu hatırlatın; birkaç saniyede bir çağırmak yeni bir şey getirmez.

Bayi fiyatlandırması

Bayi sizden kârla satmak için alır; fiyatınız onun kârına da yer bırakmalı. Öte yandan bayi hacim getirir ve size neredeyse hiç pazarlama maliyeti çıkarmaz. Asıl soru, marjınızın ne kadarını paylaşacağınızdır.

Bayi fiyatı belirleme yolları

SMMFor kişiye özel fiyatı destekler ve services komutu her müşterinin kendi fiyatını döndürür; bayi indirimini kendi panelinde hemen görür.

Örnek hesap

Tüm rakamlar örnektir. Bir servisin sağlayıcıdan 1.000 adedi size 0,60 $'a geliyor, vitrin fiyatınız 1,20 $ olsun.

Büyük bayi sipariş başına daha az kazandırır ama çok daha fazla sipariş verebilir ve sipariş başına destek ya da pazarlama maliyeti neredeyse sıfırdır. Yine de ödeme komisyonlarını, iadeleri ve zaman zaman üstlendiğiniz sağlayıcı hatalarını karşılamayan bir marjın altına inmeyin. Hesabın ayrıntıları için SMM panel fiyatlandırma ve kâr marjı yazısına ve kâr hesaplayıcıya bakabilirsiniz.

Fiyat değişikliklerini duyurmak

Bayiler fiyatlarınızı kendi panellerine senkronlar; ani bir zam, çoktan sattıkları siparişlerdeki kârı silebilir. Sağlayıcınız zam yaptığında değişikliği güncellemeler sayfanızda duyurun, mümkünse bayilere önceden haber verin. Kur dalgalanmasının sık yaşandığı Türkiye'de öngörülebilir olmak, bayilerin para ödemeye razı olduğu bir özelliktir.

Bayiler için child panel

Her bayinin kendi paneli yoktur. Bazıları bir panel ister ama script, sunucu ya da sağlayıcıyla uğraşmak istemez. Child panel (alt panel) bunu çözer: müşterinizin sitenizden kiraladığı, tek sağlayıcısı sizin paneliniz olan eksiksiz bir SMM panelidir.

SMMFor'da işleyiş:

• Child panel satışını açar, müşterilerinizin ödeyeceği aylık ücreti belirlersiniz.
• Müşteri paneli sizden satın alır; ücret sizdeki bakiyesinden düşer ve her ay yenilenir.
• Child panel, o müşterinin kendi anahtarıyla API'nize hazır bağlı gelir; siparişler onun bakiyesinden ve ona özel fiyatlarla düşer.
• Bakiye aylık ücreti karşılamazsa child panel dondurulur, ödenmezse kapanır.
• Platform, ana panelden aktif child panel başına küçük bir aylık ücret alır; tutar fiyatlar sayfasında yazar.

Modelin ayrıntıları: child panel ve 1 dolarlık child panel mi, SMM panel mi.

Kendi sağlayıcılarınızın API'leri

API'nin diğer yüzü, sizin alım yaptığınız sağlayıcılardır. SMMFor'da standart API v2 sunan herhangi bir sağlayıcıyı adresi ve API anahtarınızla eklersiniz; sağlayıcı anahtarları şifreli saklanır, servisler, fiyatlar ve durumlar otomatik senkronlanır.

Sağlayıcı tarafında dikkat edilecekler:

• Anahtarları gizli ve ayrı tutun. Her sağlayıcıda paneliniz için ayrı bir anahtar kullanın, sızıntıdan şüphelenirseniz yenileyin.
• Her şeyi kopyalamayın, eşleyin. Yalnızca test ettiğiniz ve satmak istediğiniz servisleri alın; devasa bir kopya katalog desteklenmez.
• Yukarıdaki değişiklikleri izleyin. Sağlayıcılar fiyat, min ve max değiştirir, servis kaldırır. Sipariş yönetimi bölümünde anlatılan haftalık fiyat kontrolü marjınızın kaymasını önler.
• Refill ve iptal bilgisini eşitleyin. Bayilerinize vaat ettiğiniz şey, sağlayıcınızın gerçekten desteklediğiyle aynı olmalı; bayi scriptleri bu bilgilere güvenir.
• Sağlayıcı bakiyenizi bayi talebinin önünde tutun. Büyük bir bayi günlük harcamanızı bir gecede katlayabilir. Bayi büyüdükçe sağlayıcı bakiye hedeflerinizi de yükseltin.

Sağlayıcıyı baştan nasıl seçeceğiniz SMM sağlayıcı nasıl seçilir yazısında anlatılıyor.

Yeni bir bayiyi işe almak

Bir bayinin size bağlanması tek bir anahtar oluşturmaktan ibaret değildir. İlk iki hafta, ilişkinin nasıl gideceğini belirler. Basit bir başlangıç listesi:

1. Tanışın. Bayiye hangi platformlarda ve hangi hacimde satış yaptığını sorun. Telegram üye satan biriyle Instagram beğeni satan birinin ihtiyaçları farklıdır.
2. Önce küçük başlayın. İlk yüklemenin makul bir tutar olmasını, ilk siparişlerin test niteliğinde olmasını önerin. Böylece hem siz hem bayi sürprizle karşılaşmaz.
3. Doğru servisleri gösterin. Bayinin satacağı alana göre en istikrarlı servislerinizi önerin; tüm kataloğu tek seferde içeri almasını beklemeyin.
4. Kuralları baştan konuşun. Refill süreleri, iptal desteği, iade politikası ve fiyat değişikliklerini nasıl duyurduğunuz yazılı olsun.
5. Bir iletişim kanalı açın. Bayiler için ayrı bir Telegram grubu ya da duyuru kanalı, servis kesintilerini ve fiyat değişikliklerini tek mesajla herkese ulaştırmanızı sağlar.
6. İlk ayın sonunda değerlendirin. Hacmi, iade ve refill oranını, destek yükünü görün; özel fiyat konuşmasını bu verilere göre yapın.

Bayinin size getirdiği müşterilerin şikâyetleri de dolaylı olarak size gelir. Bayiniz kendi müşterisine "sağlayıcım geciktiriyor" dediğinde o sağlayıcı sizsiniz. Bu yüzden bayiye verdiğiniz destek, perakende müşterinize verdiğinizden daha hızlı olmalıdır; nasıl kurulacağı müşteri desteği bölümünde anlatılıyor.

Kendi otomasyonunuz için Admin API

Müşteri API'sinden ayrı olarak SMMFor, kendi panelinizi koddan yönetmeniz için bir Admin API sunar: örneğin manuel servisleri işlemek, ödemeleri, kullanıcıları ve destek taleplerini yönetmek. Script yazmaya değecek tekrar eden işleriniz olduğunda işe yarar. Child panellerde kapalıdır. Ayrıntılar dokümanlarda.

Sık yapılan hatalar

• Gerçek maliyetinizi bilmeden ilk gün bayilere yüksek indirim vermek.
• Haber vermeden fiyat değiştirip bayilerin marjını bozmak.
• Servislerde yanlış refill ya da iptal bilgisi bırakmak; bayi scriptleri bunlara güvenir.
• Limite takılan bayiyi toplu sorgu ya da webhook göstermek yerine engellemek.
• Bayinin büyümesinin gece sağlayıcı bakiyenizi bitirmesine izin vermek.
• API sayfasını bayilerin bulamayacağı bir yere gömmek.

Müşteri API'si, webhook'lar ve child panelin baştan hazır geldiği bir panel istiyorsanız paketleri fiyatlar sayfasında karşılaştırabilirsiniz.

Sonraki adım

Bayiler sizi diğer müşteriler gibi arama motorlarından bulur. Panelinizi bulunur kılmak için SMM panel SEO rehberi bölümüyle devam edin. Kendi API'niz üzerinden satış yapmaya hazırsanız SMMFor'da panelinizi açın; 3 gün ücretsiz deneme ile başlayabilirsiniz.