SMM Panel API Entegrasyonu Nasıl Yapılır? HepsiSosyal API V2 Rehberi

Kendi sitenizde satılan sosyal medya hizmetlerinin siparişlerini HepsiSosyal'a tek tek aktarmak yerine smm panel api entegrasyonu ile iki sistemi birbirine bağlayabilirsiniz. Müşteriniz panelinizden bir hizmet satın aldığında sipariş bilgileri API üzerinden HepsiSosyal'a gönderilir. Aynı bağlantıyı hizmet listesini almak, siparişlerin hangi aşamada olduğunu öğrenmek ve hesap bakiyenizi sorgulamak için de kullanabilirsiniz. Entegrasyonun çalışması için hesabınıza ait API anahtarının doğru tanımlanması ve sipariş bilgilerinin ilgili parametrelerle gönderilmesi gerekir.

SMM Panel API Nedir ve Kimler Kullanır?

SMM panel api, sosyal medya hizmeti satan bir siteyle hizmet sağlayıcısının sistemi arasında veri alışverişi yapan bağlantıdır. Bir müşteri kendi panelinizden Instagram beğeni hizmeti sipariş ettiğinde siparişin hizmet numarası, hedef bağlantısı ve adedi sağlayıcıya iletilir. HepsiSosyal'ın döndürdüğü sipariş numarası da sizin sisteminizde saklanır. Böylece müşteri aynı siparişi takip ederken iki ayrı panelde elle sipariş oluşturmanızın önüne geçilir.

API bağlantısını kendi web sitesini geliştirenler, hazır SMM panel yazılımı kullanan bayiler ve müşterileri adına toplu sipariş yöneten ajanslar kullanabilir. Buradaki API, Instagram veya TikTok'un resmi uygulama API'si değil, bayinin siparişlerini HepsiSosyal'a göndermesi için sunulan bağlantıdır. Entegrasyon sipariş aktarımını yönetirken hizmetin niteliği ve hangi koşullarda sunulduğu, seçtiğiniz servisin açıklamasına bağlıdır.

HepsiSosyal API Anahtarı Nasıl Alınır?

HepsiSosyal API V2 bağlantısında her isteğin hesabınızla ilişkilendirilmesi için kişisel API anahtarınız kullanılır. Öncelikle HepsiSosyal hesabınıza giriş yapıp hesabınıza ait API anahtarını almanız gerekiyor. Anahtarın bulunduğu alanı göremiyorsanız hesap içindeki destek kanallarından bilgi alabilirsiniz. SMM panel api key olarak da aranan bu bilgi, hesabınızın API üzerinden işlem yapmasına izin verdiğinden şifreniz gibi korunmalıdır.

API bağlantısını kurmak için HepsiSosyal'ın API V2 belgesinde belirtilen adresi kullanabilirsiniz.

• API adresi — https://hepsisosyal.com/api/v2
• İstek yöntemi — POST
• Yanıt biçimi — JSON

API anahtarını tarayıcıdaki JavaScript koduna, herkese açık bir dosyaya veya Git deposuna yazmayın. Kendi sitenizin sunucusunda saklayıp istekleri sunucu üzerinden göndermeniz, anahtarın ziyaretçilere görünmesini engeller. Hazır panel yazılımı kullanıyorsanız sağlayıcı ekleme bölümündeki API adresi ve anahtar alanlarından yararlanabilirsiniz.

API V2 ile Servis Listesi Nasıl Çekilir?

HepsiSosyal'ın smm api v2 belgesinde servis listesini almak için action değerinin services olması istenir. Aynı istekte key alanına API anahtarınız gönderildiğinde sistem hizmetleri JSON biçiminde döndürür. Yanıtta her hizmetin numarasıyla beraber adı, kategorisi ve fiyatı yer alır. İlk bağlantı denemesini sipariş oluşturmadan bu işlemle yapmak, anahtarın ve adresin çalışıp çalışmadığını görmenizi sağlar.

Servis ID, Fiyat ve Sipariş Sınırları Nasıl Okunur?

Servis listesinde service hizmetin numarasını, rate fiyat bilgisini, min ve max ise sipariş için kabul edilen en düşük ve en yüksek miktarı belirtir. type alanı hizmetin sipariş türünü tanımlar. refill ve cancel alanlarıysa telafi veya iptal desteğinin ilgili hizmet için sunulup sunulmadığını bildirir. Her hizmetin aynı işlemleri desteklediğini düşünerek müşteriye koşulsuz iptal veya telafi sözü vermemelisiniz.

Servis listesini panelinize aktarırken hizmet numaralarını isimlerden bağımsız saklamanız faydalıdır. Hizmetin adı sonradan değişse bile yeni siparişin doğru servise iletilmesi bu numarayla sağlanır. Fiyat ve miktar sınırlarını da belirli aralıklarla yenileyerek panelinizde güncel olmayan bilgilerle sipariş alınmasını önleyebilirsiniz.

API Üzerinden Sipariş Nasıl Oluşturulur?

Standart bir sipariş için action=add değeriyle birlikte servis numarası, sipariş bağlantısı ve miktar gönderilir. HepsiSosyal belgesinde kullanılan parametreler aşağıdaki tabloda açıklanmıştır.

Sipariş Bağlantısı ve Adet Nasıl Gönderilir?

Bir gönderi için hizmet satın alındığında link alanında o gönderinin adresi, quantity alanında talep edilen miktar yer alır. Aşağıdaki örnek, API'ye POST isteğinin nasıl gönderildiğini gösterir. Buradaki servis numarası örnektir. Gerçek siparişte services yanıtından aldığınız numarayı kullanmalısınız.

curl -X POST 'https://hepsisosyal.com/api/v2' \

  --data-urlencode 'key=API_ANAHTARINIZ' \

  --data-urlencode 'action=add' \

  --data-urlencode 'service=1' \

  --data-urlencode 'link=https://example.com/gonderi' \

  --data-urlencode 'quantity=100'

İstek kabul edilirse API, order alanında bir sipariş numarası döndürür. Bu numarayı müşterinizin siparişiyle eşleştirmeden tekrar sipariş göndermeyin. İnternet bağlantısı kesildiğinde yanıtı alamamış olmanız, siparişin hiç oluşturulmadığı anlamına gelmez.

Ayrıca her hizmet quantity alanıyla sipariş almaz. Özel yorum hizmetinde comments, abonelik türünde username gibi farklı alanlar kullanılabildiğinden servis türüne uygun parametreleri göndermelisiniz.

Sipariş Durumu ve Bakiye Nasıl Sorgulanır?

Sipariş takibinde action=status ve order alanına kaydettiğiniz sipariş numarasını gönderirsiniz. Yanıttaki status siparişin aşamasını, start_count başlangıç sayısını, remains kalan miktarı gösterir. charge sipariş tutarını, currency ise kullanılan para birimini belirtir. Belgede Partial ve In progress gibi örnek sipariş durumları yer aldığından panelinizde yalnızca tamamlandı veya başarısız oldu şeklinde iki karşılık tanımlamamalısınız.

Birden fazla siparişi kontrol edecekseniz yine status işlemini kullanıp orders alanına virgülle ayrılmış en fazla 100 sipariş numarası gönderebilirsiniz. Böylece her sipariş için ayrı istek göndermek zorunda kalmazsınız.

HepsiSosyal bakiyesini öğrenmek içinse action=balance yeterlidir. Gelen balance ve currency bilgilerini ayrı saklamanız, satış tutarıyla sağlayıcı bakiyesini yanlışlıkla aynı para birimindeymiş gibi hesaplamanızı engeller. Kendi panelinizde smm panel sipariş takibi için bir ekran kullanıyorsanız bu bilgiler müşterilerin siparişlerini takip etmesine de yardımcı olur.

Telafi ve İptal Talepleri Nasıl Gönderilir?

Servisin refill alanı telafiyi destekliyorsa ve sipariş telafi koşullarına uygunsa action=refill ile order numarasını göndererek talep oluşturabilirsiniz. API'den gelen refill numarası telafi talebini takip etmek içindir. Sonraki sorgularda action=refill_status ile bu numarayı gönderip talebin sonucunu öğrenebilirsiniz. Bir talep numarası dönmesi, telafinin tamamlandığını göstermez.

İptal için belgede action=cancel ve orders alanı kullanılır. Tek siparişi iptal etmeyi deneseniz bile sipariş numarasını orders alanında iletirsiniz. İptal yanıtındaki hata veya sonuç her sipariş için ayrı gösterilebildiğinden müşterinizin siparişini yalnızca istek gönderildi diye iptal edilmiş işaretlemeyin.

Telafi ve iptal desteğinin servis bazında değiştiğini de satış sayfanızdaki açıklamalarla uyumlu tutmalısınız.

API ile Kendi SMM Panelinizden Nasıl Satış Yapabilirsiniz?

SMM panel bayilik api bağlantısıyla kendi siteniz üzerinden aldığınız siparişleri HepsiSosyal'a gönderebilir, müşterinize gösterdiğiniz satış fiyatını da kendi panelinizde belirleyebilirsiniz. Sağlayıcıdan çekilen fiyatla müşterinin ödediği tutar ayrı kaydedilmelidir. Böylece fiyat değiştiğinde eski siparişlerin kazanç hesabı bozulmaz ve iadeye konu bir siparişte hangi tutarın tahsil edildiği anlaşılır.

Kendi yazılımınızı kullanıyorsanız API bağlantısını kurduktan sonra hizmet listesini çekip sipariş vermeyi düşündüğünüz servisleri belirleyebilirsiniz. Ardından küçük bir deneme siparişi oluşturarak dönen sipariş numarasını kendi sipariş kaydınızla eşleştirebilir, durum ve bakiye sorgularıyla bilgilerin doğru güncellendiğini görebilirsiniz. Hata yanıtlarını ikinci kez sipariş açmadan işleyebilecek bir kontrol eklemek de yinelenen siparişleri önler.

Bu yöntem, smm otomatik sipariş sistemi kurmak isteyenlerin müşteri siparişlerini sağlayıcıya aktarmasını düzenler. Kendi yazılımını geliştirmek istemeyenler ise HepsiSosyal'ın Ücretsiz SMM Panel sayfasındaki hazır altyapı modelini değerlendirebilir. Sitede bu model, kendi markanızla panel açıp hizmet satmak için tanıtılır.

Hazır panel kurmakla mevcut yazılımınıza API eklemek aynı işlem değildir. Kendi siteniz varsa HepsiSosyal API V2 üzerinden bağlantı kurabilir, hazır bir satış paneliyle başlamak istiyorsanız ücretsiz panel modelinin sunduğu özellikleri inceleyebilirsiniz.

SMM Panel API Entegrasyonu Hakkında Sık Sorulan Sorular

SMM Panel API Kullanmak İçin Yazılım Bilgisi Şart mı?

Hazır panel yazılımında sağlayıcı ekleme alanı varsa API adresi ile anahtarı girerek bağlantı kurabilirsiniz. Kendi sitenizde sunucu tarafında sipariş oluşturma ve takip sistemi geliştirecekseniz yazılım bilgisine ihtiyaç duyarsınız.

API Anahtarı Müşterilerle Paylaşılır mı?

Hayır. Müşteriler yalnızca kendi sipariş bilgilerini görmelidir. API anahtarı sunucunuzda saklanmalı, site ziyaretçilerine veya sipariş formlarına gönderilmemelidir.

API Üzerinden Bütün Hizmetler Aynı Bilgilerle mi Sipariş Edilir?

Hayır. Standart siparişlerde bağlantı ve miktar kullanılırken özel yorum, abonelik veya farklı trafik türleri ek alanlar isteyebilir. Kullanacağınız servisin type bilgisini ve API belgesindeki ilgili parametreleri eşleştirmelisiniz.

API Bağlantısı Kurulunca Bakiye Otomatik Yüklenir mi?

Hayır. balance işlemi yalnızca mevcut bakiyeyi sorgular. API bağlantısı kurmanız, hesabınıza kendiliğinden para yatırıldığı anlamına gelmez.

API ile Bayilik Paneli Açmak Aynı Şey mi?

Değil. API mevcut sitenizi HepsiSosyal'ın sipariş sistemine bağlar. Hazır bayilik paneli modelinde ise kendi markanızla satış yapabileceğiniz panel altyapısından yararlanırsınız.