SMM panellerinin büyük çoğunluğu, siparişleri otomatikleştirmek isteyen kullanıcılar ve bayiler için bir API sunar. Bu API'lerin önemli bir kısmı benzer bir yapıyı izler ve genellikle "api/v2" adresiyle anılır. Bu SMM panel API kullanım rehberinde en temel dört komutu (services, add, status, balance), gönderilen parametreleri, dönen yanıtları ve güvenli entegrasyon için dikkat edilmesi gerekenleri anlatıyoruz.
SMM Panel API (api/v2) Temel Yapısı
Bu yapıdaki API'lerde genellikle tek bir adres bulunur, örneğin panelinizin alan adının sonuna eklenen /api/v2 yolu. Tüm istekler bu adrese HTTP POST ile gönderilir ve yapılacak işlem "action" parametresiyle belirtilir. Her istekte ayrıca "key" parametresiyle API anahtarınızı gönderirsiniz. Yanıtlar JSON biçimindedir.
- Adres: Panelin API sayfasında belirtilen uç nokta
- Yöntem: POST
- Zorunlu parametreler: key (API anahtarı) ve action (işlem adı)
- Yanıt biçimi: JSON
Önemli not: Paneller arasında küçük farklılıklar olabilir. Parametre adlarını ve desteklenen işlemleri her zaman kullandığınız panelin kendi API dokümantasyonundan doğrulayın.
1. services: Hizmet Listesini Almak
İlk adım, paneldeki hizmetleri ve kimlik numaralarını öğrenmektir. Gönderilecek parametreler:
- key = API anahtarınız
- action = services
Yanıt olarak her hizmet için genellikle şu alanları içeren bir liste döner: service (hizmet numarası), name (ad), type (tür), category (kategori), rate (genellikle bin adet başına fiyat), min ve max (sipariş alt ve üst sınırı). Bazı paneller refill ve cancel desteğini gösteren ek alanlar da döndürür.
İpucu: Hizmet listesini her istekte çekmek yerine belirli aralıklarla önbelleğe alın. Fiyat ve sınırlar değişebildiği için düzenli güncelleme yapmayı ihmal etmeyin.
2. add: Sipariş Vermek
Standart bir sipariş için gönderilen parametreler:
- key = API anahtarınız
- action = add
- service = hizmet numarası
- link = profil veya gönderi bağlantısı (kullanıcı adı isteyen hizmetlerde kullanıcı adı)
- quantity = adet
Başarılı bir istekte yanıt, sipariş numarasını içerir (örneğin "order" alanı). Hata durumunda ise "error" alanında bir açıklama döner; örneğin yetersiz bakiye, geçersiz bağlantı veya sınır dışı miktar.
Özel sipariş türleri
Bazı hizmetler farklı parametreler ister: özel yorum hizmetlerinde "comments" (her satıra bir yorum), damla besleme (drip-feed) destekli hizmetlerde "runs" ve "interval", abonelik türü hizmetlerde kullanıcı adı ve gönderi sayısı gibi alanlar. Hangi parametrelerin gerektiğini hizmet türü ve panel dokümantasyonu belirler.
3. status: Sipariş Durumunu Sorgulamak
Gönderilen parametreler:
- key = API anahtarınız
- action = status
- order = sipariş numarası
Yanıtta genellikle şu alanlar bulunur: charge (siparişten düşülen tutar), start_count (başlangıç sayısı), status (durum), remains (kalan miktar) ve currency (para birimi). Durum değerleri çoğunlukla Pending, In progress, Processing, Partial, Completed ve Canceled gibi ifadelerdir.
Birçok panel, birden fazla siparişi tek seferde sorgulamak için "orders" parametresiyle virgülle ayrılmış sipariş numaralarını kabul eder. Bu, çok sayıda siparişi takip eden bayiler için istek sayısını önemli ölçüde azaltır.
Partial durumu ne anlama gelir?
Siparişin bir kısmı teslim edilip kalanının iptal edildiğini gösterir. Bu durumda kalan miktarın ücreti genellikle bakiyenize iade edilir; panelin politikasını kontrol edin.
4. balance: Bakiye Sorgulamak
Gönderilen parametreler:
- key = API anahtarınız
- action = balance
Yanıt, "balance" ve "currency" alanlarını içerir. Otomatik sistemlerde sipariş göndermeden önce bakiyeyi kontrol etmek, yetersiz bakiye hatalarını önler ve düşük bakiyede uyarı kurmanızı sağlar.
Ek İşlemler: refill ve cancel
Birçok panel ayrıca "refill" (düşüş telafisi talebi), "refill_status" (telafi durumu) ve "cancel" (iptal) işlemlerini destekler. Bu işlemler genellikle sipariş numarasıyla çalışır, ancak her panelde bulunmayabilir. Düşüş garantisinin nasıl işlediğini merak ediyorsanız refill rehberimize göz atabilirsiniz.
Güvenli Entegrasyon İçin İpuçları
- API anahtarınızı gizli tutun: Anahtarı tarayıcı tarafı koduna veya herkese açık depolara koymayın; yalnızca sunucu tarafında kullanın.
- Hataları yakalayın: Her yanıtta "error" alanını kontrol edin ve kullanıcıya anlamlı bir mesaj gösterin.
- Zaman aşımı ve tekrar deneme: Ağ hatalarında aynı siparişi iki kez göndermemek için kendi tarafınızda kayıt tutun.
- Durum sorgularını sınırlayın: Çok sık sorgu yapmak yerine makul aralıklarla toplu sorgu kullanın.
- Kayıt tutun: Gönderilen istekleri ve yanıtları loglayın; anlaşmazlık durumunda bu kayıtlar işinize yarar.
API Sunan Panel Seçmek
Kararlı bir API, güvenilir bir panelin önemli göstergelerinden biridir. SMM panel karşılaştırma ve güvenilir SMM panelleri sayfalarında panelleri inceleyebilir, hizmet maliyetlerini fiyat karşılaştırma tablosunda görebilirsiniz. HangiSMM hizmet satmaz; API anahtarını ve bakiyeyi kullandığınız panelden alırsınız. Ayrıca API ile gönderilen etkileşimin de platform kurallarına aykırı olabileceğini ve hesap kısıtlama riski taşıdığını unutmayın.
Sıkça Sorulan Sorular
API anahtarımı nereden alırım?
Kullandığınız panelin hesap ayarları veya API sayfasından. Anahtarınızın sızdığını düşünüyorsanız panelden yeni anahtar oluşturun.
Tüm paneller aynı API yapısını mı kullanır?
Birçoğu benzer bir yapı kullanır, ancak parametre adları ve ek işlemler farklılık gösterebilir. Her zaman panelin kendi dokümantasyonunu esas alın.
rate değeri neyi ifade eder?
Genellikle bin adet başına fiyatı ifade eder. Ancak bazı hizmetlerde farklı birim kullanılabilir; panelin açıklamasını kontrol edin.
Aynı siparişi yanlışlıkla iki kez gönderirsem ne olur?
Panel genellikle iki ayrı sipariş olarak işler ve iki kez ücret keser. Bunu önlemek için kendi sisteminizde sipariş kaydı tutup tekrar gönderimi engelleyin.