SMM Panel API Dokümanı

SMM panel API nedir?

SMM panel API, bir programın web sitesine girmeden hizmet listesini almasını, sipariş vermesini, sipariş durumunu ve bakiyeyi kontrol etmesini sağlar. 4SNS PLUS, birçok panel ve botun kullandığı standart SMM panel API v2 biçimini destekler; başka bir panele bağladığınız kod, URL ve anahtarı değiştirdiğiniz anda çalışır.

API fiyatları ve bakiye web sitesiyle aynıdır. services yanıtındaki rate, fiyat listesindeki 1,000 başına fiyata (ABD doları) eşittir; add ile verilen siparişler bakiyeden web siparişleriyle tamamen aynı şekilde düşülür ve panelinizdeki sipariş geçmişinde de görünür. İptal edilen veya kısmi tamamlanan siparişlerden dönen tutarlar aynı bakiyeye geri yüklenir.

Temel bilgiler

İstek örneği

curl -X POST https://4snsplus.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=balance

import requests

r = requests.post("https://4snsplus.com/api/v2", data={
    "key": "YOUR_API_KEY",
    "action": "add",
    "service": 2210,
    "link": "https://t.me/yourchannel",
    "quantity": 1000,
})
print(r.json())  # {"order": 31877} or {"error": "..."}

API anahtarını nasıl alırım?

İlk bakiye yüklemeniz hesabınıza yansıdığında, panelinizdeki API anahtarı menüsünden bir API anahtarı oluşturabilirsiniz. Anahtar yalnızca oluşturulduğu anda bir kez gösterilir, bu yüzden güvenli bir yerde saklayın. Yeni bir anahtar oluşturduğunuzda önceki anahtar hemen devre dışı kalır.

Anahtar, hesap token'ınızdan ayrıdır. Botunuza veya sunucunuza yalnızca API anahtarını koyun, hesap token'ınızı asla koymayın. Anahtarınızın başkasının eline geçtiğini düşünüyorsanız API anahtarı ekranından yenisini oluşturmanız yeterli.

Hizmet listesi (services)

Sipariş verebileceğiniz tüm hizmetleri döndürür. rate, 1,000 başına fiyattır (USD); type Package olduğunda bir paketin fiyatıdır. type Custom Comments olduğunda miktar yerine yorum listesi gönderirsiniz. category, platform adı ile grup adından oluşur.

Yanıt örneği

[
  {
    "service": 2210,
    "name": "Members - 30 Days Non Drop - 30 Days Refill",
    "type": "Default",
    "category": "Telegram - Members (30 Days Non Drop)",
    "rate": "1.4300",
    "min": "100",
    "max": "50000",
    "refill": true,
    "cancel": false
  }
]

Sipariş ver (add)

Sipariş oluşturur ve tutarı bakiyenizden düşer. Tutar, 1,000 başına fiyat ile miktarın çarpımıdır; Package için paket fiyatıdır, Custom Comments için yorum satırı sayısı miktar olarak sayılır. Sipariş, ilk bakiye yüklemesi yansımış hesaplarda kullanılabilir. Yanıttaki order, sipariş ID'nizdir.

Yanıt örneği

{
  "order": 31877
}

Sipariş durumu (status)

Tek bir siparişin durumu. charge, iadelerden sonra gerçekte ödenen tutardır (USD, 6 ondalık), start_count siparişin başladığı andaki sayı, remains ise henüz teslim edilmeyen miktardır.

Yanıt örneği

{
  "charge": "1.430000",
  "start_count": "8120",
  "status": "In progress",
  "remains": "410",
  "currency": "USD"
}

Çoklu sipariş durumu (status, orders)

Sipariş ID'leri virgülle birleştirilerek tek seferde en fazla 100 sipariş kontrol edilir. Var olmayan veya hesabınıza ait olmayan ID'lerin yerine hata döner.

Yanıt örneği

{
  "1": { "charge": "0.300000", "start_count": "120", "status": "Completed", "remains": "0", "currency": "USD" },
  "10": { "error": "Incorrect order ID" }
}

Refill talebi (refill)

Refill süresi olan bir hizmetin Completed veya Partial olarak biten siparişi için, bittiği andan itibaren sayılan Refill süresi içinde talep gönderin. Her siparişte bir açık talep olabilir ve talepler arasında 24 saat olmalıdır.

Yanıt örneği

{
  "refill": 512
}

Refill durumu (refill_status)

Tek bir Refill talebinin durumu.

Yanıt örneği

{
  "status": "Completed"
}

Bakiye (balance)

Bakiyeniz (USD, 6 ondalık).

Yanıt örneği

{
  "balance": "84.120000",
  "currency": "USD"
}

Sipariş durumu değerleri

Refill durumu değerleri

Hata mesajları

Hatalar, HTTP 200 yanıtında error alanı içeren JSON olarak döner. Kodunuzda önce error alanını kontrol edin.

{
  "error": "Not enough funds on balance"
}

SMM panel API bir Telegram botuna nasıl bağlanır?