SMM Panel API Dokumentation

Was ist eine SMM Panel API?

Mit einer SMM Panel API ruft ein Programm die Serviceliste ab, gibt Bestellungen auf und prüft Bestellstatus und Guthaben, ohne die Website zu nutzen. 4SNS PLUS unterstützt das Standardformat SMM Panel API v2, das viele Panels und Bots verwenden. Code, den Sie schon an ein anderes Panel angebunden haben, funktioniert also sofort, sobald Sie URL und Key austauschen.

Preise und Guthaben sind in der API dieselben wie auf der Website. Die rate in der services Antwort entspricht dem Preis pro 1,000 (US-Dollar) in der Preisliste. Bestellungen über add werden genau wie Webbestellungen vom Guthaben abgebucht und erscheinen auch im Bestellverlauf in Ihrem Dashboard. Beträge aus stornierten oder teilweise gelieferten Bestellungen gehen auf dasselbe Guthaben zurück.

Grundlagen

Anfragebeispiel

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": "..."}

Wie bekomme ich einen API Key?

Sobald Ihre erste Aufladung auf dem Guthaben gutgeschrieben ist, erstellen Sie im Menü API Key in Ihrem Dashboard einen API Key. Der Key wird nur einmal beim Erstellen angezeigt, speichern Sie ihn also an einem sicheren Ort. Ein neuer Key deaktiviert den bisherigen Key sofort.

Der Key ist von Ihrem Konto-Token getrennt. Hinterlegen Sie in Ihrem Bot oder Server nur den API Key, nie Ihr Konto-Token. Falls Ihr Key bekannt geworden sein könnte, erstellen Sie einfach auf der API Key Seite einen neuen.

Serviceliste (services)

Liefert alle Services, die Sie bestellen können. rate ist der Preis pro 1,000 (USD), bei type Package der Preis für ein Paket. Bei type Custom Comments senden Sie statt einer Menge eine Liste von Kommentaren. category besteht aus Plattformname und Gruppenname.

Antwortbeispiel

[
  {
    "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
  }
]

Bestellung aufgeben (add)

Gibt eine Bestellung auf und bucht den Betrag vom Guthaben ab. Der Betrag ist der Preis pro 1,000 mal der Menge; bei Package ist es der Paketpreis, bei Custom Comments zählt die Anzahl der Kommentarzeilen als Menge. Bestellen können Konten, deren erste Aufladung gutgeschrieben ist. order in der Antwort ist Ihre Bestell-ID.

Antwortbeispiel

{
  "order": 31877
}

Bestellstatus (status)

Der Status einer Bestellung. charge ist der tatsächlich bezahlte Betrag nach Erstattungen (USD, 6 Nachkommastellen), start_count ist der Zählerstand beim Start der Bestellung und remains die noch nicht gelieferte Menge.

Antwortbeispiel

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

Status mehrerer Bestellungen (status, orders)

Prüft bis zu 100 Bestellungen auf einmal, die Bestell-IDs mit Kommas getrennt. IDs, die nicht existieren oder nicht zu Ihrem Konto gehören, erhalten an ihrer Stelle einen Fehler.

Antwortbeispiel

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

Refill anfordern (refill)

Für eine Bestellung eines Services mit Refill-Zeitraum, die als Completed oder Partial abgeschlossen wurde: innerhalb des Refill-Zeitraums ab Abschluss anfordern. Pro Bestellung ist eine offene Anfrage möglich, mit 24 Stunden Abstand zwischen den Anfragen.

Antwortbeispiel

{
  "refill": 512
}

Refill-Status (refill_status)

Der Status einer Refill-Anfrage.

Antwortbeispiel

{
  "status": "Completed"
}

Guthaben (balance)

Ihr Guthaben (USD, 6 Nachkommastellen).

Antwortbeispiel

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

Werte für den Bestellstatus

Werte für den Refill-Status

Fehlermeldungen

Fehler kommen als JSON mit einem error Feld in einer HTTP 200 Antwort. Prüfen Sie in Ihrem Code zuerst das error Feld.

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

Wie verbinde ich eine SMM Panel API mit einem Telegram Bot?