Home / Sviluppatori / Orders API

Orders API

Aggiungi smm.guide al tuo pannello come fornitore. Ogni percorso che crei nel tuo account è un servizio con un proprio ID: il tuo pannello invia un ordine a quell'ID e il percorso lo passa al primo dei tuoi fornitori in grado di accettarlo.

Tre passaggi

Il formato è quello che i pannelli SMM usano già tra loro, quindi non c'è nulla da programmare.

1Crea un percorsoAccount, Orders desk, Percorsi. Scegli cosa fornisce e aggiungi fino a cinque servizi di quel tipo dai pannelli che hai collegato.
2Crea la chiaveOrders desk, Orders API. La chiave viene mostrata una sola volta. Puoi limitarla all'indirizzo del server del tuo pannello.
3Aggiungi un fornitore nel tuo pannelloURL API https://smm.guide/api/v2 e la chiave. Importa i servizi: i tuoi percorsi arrivano con i loro ID, prezzi e limiti.

Formato della richiesta

Metodo HTTPPOST
URL APIhttps://smm.guide/api/v2
Corpoapplication/x-www-form-urlencoded, oppure JSON con Content-Type: application/json. A multipart/form-data viene letto anch'esso: è ciò che PHP invia quando a cURL viene passato un array
RispostaJSON, sempre con HTTP 200, anche per un corpo illeggibile o una richiesta troppo grande. Un errore è {"error": "…"}
ImportiDollari USA. I prezzi sono per 1.000

Elenco dei servizi

I tuoi percorsi che possono accettare un ordine in questo momento. Un percorso disattivato, o con tutti i passaggi esclusi, non compare.

ParametroDescrizione
keyLa tua chiave API
actionservices

Risposta

[
  {
    "service": 85725095,
    "name": "TG views, main",
    "type": "Default",
    "category": "Telegram views",
    "rate": "0.0018",
    "min": "10",
    "max": "1000000",
    "refill": false,
    "cancel": true,
    "dripfeed": false
  }
]

rate corrisponde al passaggio più caro del percorso che può accettare un ordine, compresi quelli saltati al momento (un pannello non disponibile oggi torna domani), così un ordine non costa mai più del prezzo importato dal tuo pannello. min e max sono i limiti più ampi coperti dall'insieme dei passaggi funzionanti; una quantità che rientra solo in alcuni di essi va a uno di quelli. refill e cancel valgono true quando tutti questi passaggi li offrono.

Un percorso disattivato, o senza alcun passaggio funzionante, viene escluso da questo elenco finché non torna disponibile. Un pannello che sincronizza i servizi automaticamente disattiverà quel servizio dalla sua parte per lo stesso periodo, ed è proprio ciò che vuoi: i suoi ordini verrebbero rifiutati.

Aggiungi ordine

ParametroDescrizione
keyLa tua chiave API
actionadd
serviceL'ID del percorso, otto cifre
linkLink alla pagina, al post o al profilo
quantityQuantità richiesta

Risposta

{
  "order": 23501
}

Nessuno l'ha accettato

{
  "error": "No step of this route accepted the order. …"
}

Il numero d'ordine resta lo stesso per tutta la vita dell'ordine, qualunque fornitore finisca per eseguirlo. Un percorso accetta un link e una quantità; drip-feed, commenti e altri campi aggiuntivi vengono rifiutati.

Stato dell'ordine

ParametroDescrizione
keyLa tua chiave API
actionstatus
orderID ordine

Risposta

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
ParametroDescrizione
keyLa tua chiave API
actionstatus
ordersID ordine separati da una virgola, fino a 100

Risposta

{
  "23501": {
    "charge": "0.0045",
    "start_count": "3572",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "99": { "error": "Incorrect order ID" }
}
StatoSignificato
PendingAccettato da un fornitore e non ancora avviato. Anche un ordine su cui un fornitore non ha dato una risposta chiara: il percorso si ferma lì finché non lo hai controllato nel tuo account.
In progress, ProcessingUn fornitore lo sta eseguendo, oppure l'ordine sta passando al passaggio successivo.
CompletedConsegnato per intero.
PartialConsegnato in parte; remains è la parte non consegnata. Conta ciò che ha consegnato ogni passaggio: se un passaggio ha consegnato una parte e il resto è stato annullato su quello successivo, l'ordine è Partial, non Canceled. È il fornitore a decidere sulla restituzione del resto dell'importo.
CanceledNon è stato consegnato nulla e nessun altro passaggio ha accettato l'ordine. charge indica l'eventuale importo rimasto addebitato.

charge è l'importo addebitato dai fornitori per questo ordine, in dollari al cambio del giorno in cui è stato effettuato. start_count proviene dal fornitore che lo ha avviato.

Saldo

smm.guide non detiene denaro tuo. La cifra è la somma dei tuoi saldi sui pannelli dietro i tuoi percorsi, in dollari.

ParametroDescrizione
keyLa tua chiave API
actionbalance

Risposta

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

Annulla

Trasmesso al fornitore che detiene l'ordine in quel momento, se il suo servizio prevede l'annullamento. Un ordine che annulli non viene mai inoltrato al passaggio successivo.

ParametroDescrizione
keyLa tua chiave API
actioncancel
ordersID ordine separati da una virgola, fino a 100

Risposta

[
  { "order": 23501, "cancel": 1 },
  { "order": 23502, "cancel": { "error": "The order is already finished" } }
]

Refill

Trasmesso al fornitore che ha consegnato l'ordine. Il refill riporta il numero dell'ordine stesso.

ParametroDescrizione
keyLa tua chiave API
actionrefill
orderID ordine. Oppure orders: più ID, separati da una virgola

Risposta, un ordine

{ "refill": "23501" }

Risposta, più ordini

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
ParametroDescrizione
keyLa tua chiave API
actionrefill_status
refillID refill. Oppure refills: più ID, separati da una virgola

Risposta

{ "status": "Completed" }

Cosa fa un percorso con un ordine

  • I passaggi vengono provati nel tuo ordine, oppure a partire dal più economico funzionante. Scegli tu quale nel percorso.
  • Un passaggio viene saltato quando il suo pannello non risponde, il suo saldo o limite giornaliero non copre l'ordine, la quantità è fuori dai limiti che accetta, il suo prezzo supera il limite che hai impostato oppure, a quel prezzo, l'ordine supererebbe il limite giornaliero del percorso. Rientra da solo.
  • Un passaggio viene escluso quando il suo servizio esce dal listino o il pannello inizia a vendere qualcos'altro con lo stesso ID. Gli altri passaggi continuano a funzionare e ricevi un avviso.
  • Un rifiuto fa passare l'ordine al successivo. Quando un pannello risponde e rifiuta, non è stato addebitato nulla, quindi si prova il passaggio successivo.
  • Una risposta non chiara lo ferma. Un timeout o una risposta non valida non dicono se l'ordine esiste. Inoltrarlo potrebbe farlo eseguire e addebitare due volte, quindi il percorso si ferma e controlli quell'ordine nel tuo account.
  • Un solo ordine attivo per link. Mentre un ordine per un link è in corso su un percorso, un secondo ordine per lo stesso link viene rifiutato, come fanno gli stessi fornitori.
  • Anche un annullamento prima della consegna può passare al successivo, se hai attivato questa opzione. Ciò che un ordine parziale non ha consegnato passa al successivo solo se lo hai richiesto.

Errori

ErroreCosa significa
Invalid API keyLa chiave è errata, sostituita o revocata.
This key is limited to certain addresses…La richiesta proviene da un indirizzo che non è nell'elenco della chiave.
Incorrect requestSconosciuto action.
Incorrect service IDNessuno dei tuoi percorsi ha questo ID. Un percorso eliminato mantiene il suo numero, che non viene mai assegnato a un altro.
Incorrect order IDNessuno dei tuoi ordini ha questo numero.
Link is required, Quantity is requiredUn campo tra add manca o non è un numero.
A route takes a link and a quantity onlyLa richiesta conteneva drip-feed, commenti o un altro campo aggiuntivo.
This route is switched offAttivalo nel tuo account.
This route already has an order for this link…Attendi che quello in corso sia terminato.
No step of this route can take this order right now. …Tutti i passaggi sono stati saltati prima di inviare qualcosa. Il testo indica ogni pannello e il relativo motivo.
No step of this route accepted the order. …Tutti i passaggi interpellati hanno rifiutato. Non è stato addebitato nulla.
Too many requests…Oltre il limite indicato sotto. Attendi un minuto.

Esempi

cURL

curl https://smm.guide/api/v2 \
  -d key=sgo_… \
  -d action=add \
  -d service=85725095 \
  -d link=https://t.me/channel/123 \
  -d quantity=1000

PHP

function smmguide(array $post) {
  $ch = curl_init('https://smm.guide/api/v2');
  curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query(
      ['key' => 'sgo_…'] + $post),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
  ]);
  $out = json_decode(curl_exec($ch), true);
  curl_close($ch);
  return $out;
}
$order = smmguide(['action' => 'add',
  'service' => 85725095,
  'link' => 'https://t.me/channel/123',
  'quantity' => 1000]);

Una richiesta add riceve sempre risposta entro 30 secondi. Un percorso può interpellare più fornitori uno dopo l'altro; ciascuno ha a disposizione il tempo rimanente e un fornitore che non si farebbe in tempo ad attendere non viene interpellato affatto. Se l'ultimo interpellato non ha risposto allo scadere del tempo, ricevi un numero d'ordine con lo stato Pending e il percorso si ferma lì finché la risposta non è nota. La maggior parte degli ordini riceve risposta in uno o due secondi.

Limiti e sicurezza

  • 300 richieste al minuto per chiave, di cui 120 ordini. Fino a 100 ID di ordine in una sola status chiamata.
  • La chiave viene mostrata una sola volta e conservata come impronta. Né tu né noi possiamo rileggerla. Se la sostituisci, quella vecchia viene disattivata subito.
  • Indirizzi consentiti. Indica nel tuo account l'indirizzo del server del tuo pannello e la chiave non funzionerà da nessun'altra parte.
  • L'ID di un percorso non è un segreto e non ha bisogno di esserlo. Funziona solo insieme alla chiave dell'account a cui appartiene il percorso.
  • I tuoi limiti restano validi. Il limite giornaliero di ogni pannello, il limite giornaliero del percorso e il suo ordine massimo si applicano agli ordini che arrivano tramite l'API esattamente come a quelli che effettui a mano.
  • Il denaro non passa mai da smm.guide. Ogni ordine viene pagato con il tuo saldo sul pannello che lo accetta. Rimborsi e contestazioni restano tra te e quel pannello.

Vuoi invece leggere il catalogo?

Pannelli, Trust Score e prezzi aggiornati hanno una propria API e un server MCP per gli assistenti.