Dokumentacja API panelu SMM

Czym jest API panelu SMM?

API panelu SMM pozwala programowi pobrać listę usług, składać zamówienia oraz sprawdzać status zamówień i saldo bez wchodzenia na stronę. 4SNS PLUS obsługuje standardowy format API v2 panelu SMM, z którego korzysta wiele paneli i botów, więc kod podłączony już do innego panelu działa od razu po zmianie adresu URL i klucza.

Ceny i saldo w API są takie same jak na stronie. rate w odpowiedzi services to cena za 1,000 (dolary USA) z cennika, a zamówienia złożone przez add są pobierane z salda tak samo jak zamówienia na stronie i pojawiają się w historii zamówień w Twoim panelu. Kwoty zwrócone z anulowanych lub częściowych zamówień wracają na to samo saldo.

Podstawy

Przykład zapytania

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

Jak zdobyć klucz API?

Gdy pierwsze doładowanie zostanie zaksięgowane na saldzie, możesz utworzyć klucz API w menu Klucz API w swoim panelu. Klucz jest pokazywany tylko raz przy tworzeniu, więc zapisz go w bezpiecznym miejscu. Utworzenie nowego klucza od razu wyłącza poprzedni.

Klucz jest oddzielony od tokenu konta. W bocie lub na serwerze umieść tylko klucz API, nigdy token konta. Jeśli podejrzewasz, że klucz wyciekł, po prostu utwórz nowy na ekranie Klucz API.

Lista usług (services)

Zwraca wszystkie usługi, które możesz zamówić. rate to cena za 1,000 (USD), a gdy type to Package, jest to cena jednego pakietu. Gdy type to Custom Comments, zamiast ilości wysyłasz listę komentarzy. category to nazwa platformy plus nazwa grupy.

Przykład odpowiedzi

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

Złóż zamówienie (add)

Składa zamówienie i pobiera kwotę z salda. Kwota to cena za 1,000 razy ilość; dla Package to cena pakietu, a dla Custom Comments ilością jest liczba linii komentarzy. Zamówienia są dostępne na kontach z zaksięgowanym pierwszym doładowaniem. order w odpowiedzi to ID Twojego zamówienia.

Przykład odpowiedzi

{
  "order": 31877
}

Status zamówienia (status)

Status jednego zamówienia. charge to faktycznie zapłacona kwota po zwrotach (USD, 6 miejsc po przecinku), start_count to licznik w chwili startu zamówienia, a remains to ilość jeszcze niedostarczona.

Przykład odpowiedzi

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

Status wielu zamówień (status, orders)

Sprawdza do 100 zamówień naraz, z ID zamówień rozdzielonymi przecinkami. ID, które nie istnieją lub nie należą do Twojego konta, dostają w swoim miejscu błąd.

Przykład odpowiedzi

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

Zgłoś uzupełnienie (refill)

Dla zamówienia usługi z okresem uzupełnienia, które zakończyło się jako Completed lub Partial, zgłoś prośbę w okresie uzupełnienia liczonym od zakończenia zamówienia. Każde zamówienie może mieć jedną otwartą prośbę, z 24 godzinami odstępu między prośbami.

Przykład odpowiedzi

{
  "refill": 512
}

Status uzupełnienia (refill_status)

Status jednej prośby o uzupełnienie.

Przykład odpowiedzi

{
  "status": "Completed"
}

Saldo (balance)

Twoje saldo (USD, 6 miejsc po przecinku).

Przykład odpowiedzi

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

Wartości statusu zamówienia

Wartości statusu uzupełnienia

Komunikaty błędów

Błędy przychodzą jako JSON z polem error w odpowiedzi HTTP 200. W kodzie najpierw sprawdzaj pole error.

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

Jak podłączyć API panelu SMM do bota Telegram?