Documentazione API del pannello SMM

Che cos'è l'API di un pannello SMM?

L'API di un pannello SMM permette a un programma di ottenere l'elenco dei servizi, inviare ordini e controllare stato degli ordini e saldo senza passare dal sito. 4SNS PLUS supporta il formato standard API v2 dei pannelli SMM usato da molti pannelli e bot: il codice che hai già collegato a un altro pannello funziona subito, basta cambiare URL e chiave.

Prezzi e saldo dell'API sono gli stessi del sito. Il rate nella risposta di services corrisponde al prezzo per 1,000 (dollari USA) del listino, e gli ordini inviati con add vengono scalati dal saldo esattamente come gli ordini web e compaiono anche nello storico ordini della tua dashboard. Gli importi restituiti da ordini annullati o parziali tornano sullo stesso saldo.

Nozioni di base

Esempio di richiesta

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

Come ottengo una chiave API?

Quando la prima ricarica è accreditata sul saldo, puoi creare una chiave API dal menu Chiave API della tua dashboard. La chiave viene mostrata una sola volta al momento della creazione, quindi conservala in un posto sicuro. Creando una nuova chiave, quella precedente viene disattivata subito.

La chiave è separata dal token del tuo account. Nel bot o sul server inserisci solo la chiave API, mai il token dell'account. Se pensi che la chiave sia stata esposta, crea semplicemente una nuova chiave nella schermata Chiave API.

Elenco servizi (services)

Restituisce tutti i servizi che puoi ordinare. rate è il prezzo per 1,000 (USD); quando type è Package è il prezzo di un pacchetto. Quando type è Custom Comments invii un elenco di commenti al posto della quantità. category è il nome della piattaforma più il nome del gruppo.

Esempio di risposta

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

Inviare un ordine (add)

Invia un ordine e scala l'importo dal saldo. L'importo è il prezzo per 1,000 moltiplicato per la quantità; per Package è il prezzo del pacchetto e per Custom Comments la quantità è il numero di righe di commento. Gli ordini sono disponibili per gli account con la prima ricarica accreditata. order nella risposta è l'ID del tuo ordine.

Esempio di risposta

{
  "order": 31877
}

Stato dell'ordine (status)

Lo stato di un ordine. charge è l'importo effettivamente pagato dopo i rimborsi (USD, 6 decimali), start_count è il conteggio all'avvio dell'ordine e remains è la quantità non ancora consegnata.

Esempio di risposta

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

Stato di più ordini (status, orders)

Controlla fino a 100 ordini insieme, con gli ID ordine separati da virgole. Gli ID inesistenti o non presenti sul tuo account ricevono un errore al loro posto.

Esempio di risposta

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

Richiedere un refill (refill)

Per un ordine di un servizio con periodo di refill concluso come Completed o Partial, invia la richiesta entro il periodo di refill calcolato dalla fine dell'ordine. Ogni ordine può avere una richiesta aperta alla volta, con 24 ore tra una richiesta e l'altra.

Esempio di risposta

{
  "refill": 512
}

Stato del refill (refill_status)

Lo stato di una richiesta di refill.

Esempio di risposta

{
  "status": "Completed"
}

Saldo (balance)

Il tuo saldo (USD, 6 decimali).

Esempio di risposta

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

Valori dello stato ordine

Valori dello stato refill

Messaggi di errore

Gli errori arrivano come JSON con un campo error in una risposta HTTP 200. Nel tuo codice controlla prima il campo error.

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

Come collego l'API di un pannello SMM a un bot Telegram?