Vai al contenuto

Documentazione API v2 del pannello SMM

1PANEL PLUS usa l'API v2 standard per pannelli SMM. Invia una richiesta POST con la tua chiave API e un'azione; ogni risposta è in JSON. Prezzi e saldo sono gli stessi del sito.

Nozioni di base

Endpoint
https://1panelplus.com/api/v2
Metodo
POST
Parametri
Campi del modulo o corpo JSON
La tua chiave API
Dalla pagina Chiave API della tua dashboard
Limite di richieste
300 richieste al minuto per chiave

Esempio di richiesta

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

Elenco servizi

Tutti i servizi attivi. rate è il prezzo per 1.000 in USD, oppure il prezzo di un pacchetto quando type è Package.

ParametroDescrizione
keyLa tua chiave API
actionservices

Esempio di risposta

[
  {
    "service": 1204,
    "name": "YouTube Views - 30 Days Refill",
    "type": "Default",
    "category": "YouTube - Views (30 Days Refill)",
    "rate": "1.5600",
    "min": "100",
    "max": "1000000",
    "refill": true,
    "cancel": false
  }
]

Aggiungi ordine

Effettua un ordine e ne scala il prezzo dal saldo. Per Custom Comments, invia comments (uno per riga) al posto di quantity.

ParametroDescrizione
keyLa tua chiave API
actionadd
serviceID del servizio
linkLink al video, Short, diretta o canale
quantityQuantità (non per Custom Comments o Package)
commentsSolo Custom Comments: un commento per riga

Esempio di risposta

{
  "order": 23501
}

Stato dell'ordine

Stato di un ordine. charge è quanto hai pagato, in USD.

ParametroDescrizione
keyLa tua chiave API
actionstatus
orderID dell'ordine

Esempio di risposta

{
  "charge": "1.560000",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}

Stato multiplo

Stato di massimo 100 ordini, separati da virgola.

ParametroDescrizione
keyLa tua chiave API
actionstatus
ordersID degli ordini, ad esempio 1,10,100

Esempio di risposta

{
  "1": { "charge": "0.270000", "start_count": "3572", "status": "Partial", "remains": "157", "currency": "USD" },
  "10": { "error": "Incorrect order ID" }
}

Refill

Richiede un refill per un ordine terminato di un servizio con refill.

ParametroDescrizione
keyLa tua chiave API
actionrefill
orderID dell'ordine

Esempio di risposta

{
  "refill": 412
}

Stato del refill

Stato di una richiesta di refill.

ParametroDescrizione
keyLa tua chiave API
actionrefill_status
refillID del refill

Esempio di risposta

{
  "status": "Completed"
}

Saldo

Il tuo saldo in USD.

ParametroDescrizione
keyLa tua chiave API
actionbalance

Esempio di risposta

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

Stati dell'ordine

PendingRicevuto, in attesa di partire
In progressIn consegna
CompletedConsegnato per intero
PartialConsegnato in parte; il resto rimborsato sul saldo
CanceledNon consegnato; rimborsato per intero

Errori

Gli errori vengono restituiti in JSON con un messaggio error, ad esempio:

{
  "error": "Not enough funds on balance"
}
Invalid API keyLa chiave manca, è errata o è stata sostituita
Incorrect service IDNessun servizio attivo con questo ID
Incorrect linkIl link è vuoto o non è un indirizzo web
Quantity out of rangeSotto il minimo o sopra il massimo del servizio
Not enough funds on balanceRicarica prima il saldo
Too many requestsPiù di 300 richieste in un minuto