Tuis / Ontwikkelaars / Orders API

Orders API

Voeg smm.guide as verskaffer by u paneel. Elke roete wat u in u rekening bou, is ’n diens met sy eie ID: u paneel stuur ’n bestelling na daardie ID, en die roete gee dit aan die eerste van u verskaffers wat dit kan neem.

Drie stappe

Die formaat is dié wat SMM-panele reeds onderling gebruik, so daar is niks om te programmeer nie.

1Bou ’n roeteRekening, Orders desk, Roetes. Kies wat dit lewer en voeg tot vyf dienste van daardie soort by uit die panele wat u gekoppel het.
2Skep die sleutelOrders desk, Orders API. Die sleutel word een keer gewys. U kan dit beperk tot die adres van u paneel se bediener.
3Voeg ’n verskaffer in u paneel byAPI-URL https://smm.guide/api/v2 en die sleutel. Voer die dienste in: u roetes kom aan met hul ID’s, pryse en limiete.

Versoekformaat

HTTP-metodePOST
API-URLhttps://smm.guide/api/v2
Liggaamapplication/x-www-form-urlencoded, of JSON met Content-Type: application/json. A multipart/form-data liggaam word ook gelees, wat PHP stuur wanneer cURL ’n skikking kry
AntwoordJSON, altyd met HTTP 200, ook vir ’n liggaam wat ons nie kan lees nie of ’n versoek wat te groot is. ’n Fout is {"error": "…"}
GeldAmerikaanse dollar. Pryse is per 1 000

Dienslys

U roetes wat nou ’n bestelling kan neem. ’n Roete wat afgeskakel is, of waarvan elke stap uit is, word nie gelys nie.

ParameterBeskrywing
keyU API-sleutel
actionservices

Antwoord

[
  {
    "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 is die duurste van die roete se stappe wat ’n bestelling kan neem, dié wat tydelik oorgeslaan word ingesluit (’n paneel wat vandag af is, is môre terug), sodat ’n bestelling nooit meer kos as die prys wat u paneel ingevoer het nie. min en max is die wydste wat die werkende stappe saam dek; ’n hoeveelheid wat net by sommige van hulle pas, gaan na een daarvan. refill en cancel is waar wanneer elke sodanige stap dit aanbied.

’n Roete wat afgeskakel is, of geen stap het wat kan werk nie, word uit hierdie lys gelaat totdat dit terug is. ’n Paneel wat sy dienste outomaties sinchroniseer, sal daardie diens vir dieselfde tyd aan sy kant afskakel, en dit is wat u wil hê: sy bestellings sou geweier word.

Voeg bestelling by

ParameterBeskrywing
keyU API-sleutel
actionadd
serviceDie roete se ID, agt syfers
linkSkakel na die bladsy, plasing of profiel
quantityBenodigde hoeveelheid

Antwoord

{
  "order": 23501
}

Niks het dit aanvaar nie

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

Die bestelnommer bly dieselfde vir die hele leeftyd van die bestelling, watter verskaffer dit ook al uiteindelik lewer. ’n Roete neem ’n skakel en ’n hoeveelheid; geleidelike lewering, kommentaar en ander ekstra velde word geweier.

Bestellingstatus

ParameterBeskrywing
keyU API-sleutel
actionstatus
orderBestelling-ID

Antwoord

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
ParameterBeskrywing
keyU API-sleutel
actionstatus
ordersBestelling-ID’s geskei deur ’n komma, tot 100

Antwoord

{
  "23501": {
    "charge": "0.0045",
    "start_count": "3572",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "99": { "error": "Incorrect order ID" }
}
StatusBetekenis
PendingDeur ’n verskaffer aanvaar en nog nie begin nie. Ook ’n bestelling waarop ’n verskaffer geen duidelike antwoord gegee het nie: die roete stop daar totdat u dit in u rekening nagegaan het.
In progress, Processing’n Verskaffer lewer dit, of die bestelling is op pad na die volgende stap.
CompletedVolledig gelewer.
PartialDeels gelewer; remains is wat nie gelewer is nie. Dit tel wat elke stap gelewer het: wanneer een stap ’n deel gelewer het en die res op die volgende gekanselleer is, is die bestelling Partial, nie Canceled nie. Die verskaffer besluit oor die terugbetaling van die res van die koste.
CanceledNiks is gelewer nie, en geen ander stap het die bestelling geneem nie. charge wys wat gehef gebly het, as daar iets is.

charge is wat die verskaffers vir hierdie bestelling gehef het, in dollar teen die koers van die dag waarop dit geplaas is. start_count kom van die verskaffer wat dit begin het.

Saldo

smm.guide hou geen geld van u nie. Die syfer is die som van u saldo’s op die panele agter u roetes, in dollar.

ParameterBeskrywing
keyU API-sleutel
actionbalance

Antwoord

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

Kanselleer

Word deurgegee aan die verskaffer wat die bestelling nou hou, as sy diens ’n kansellasie aanbied. ’n Bestelling wat u kanselleer, word nooit na die volgende stap aangestuur nie.

ParameterBeskrywing
keyU API-sleutel
actioncancel
ordersBestelling-ID’s geskei deur ’n komma, tot 100

Antwoord

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

Navulling

Word deurgegee aan die verskaffer wat die bestelling gelewer het. Die navulling dra die bestelling se eie nommer.

ParameterBeskrywing
keyU API-sleutel
actionrefill
orderBestelling-ID. Of orders: verskeie, geskei deur ’n komma

Antwoord, een bestelling

{ "refill": "23501" }

Antwoord, verskeie

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
ParameterBeskrywing
keyU API-sleutel
actionrefill_status
refillNavulling-ID. Of refills: verskeie, geskei deur ’n komma

Antwoord

{ "status": "Completed" }

Wat ’n roete met ’n bestelling doen

  • Die stappe word in u volgorde probeer, of die goedkoopste werkende een eerste. U kies watter in die roete.
  • ’n Stap word oorgeslaan wanneer sy paneel nie antwoord nie, sy saldo of daaglikse limiet nie die bestelling dek nie, die hoeveelheid buite sy grense val, sy prys bo die limiet is wat u gestel het, of die bestelling teen sy prys die roete se eie daaglikse limiet sou oorskry. Dit kom vanself terug.
  • ’n Stap val uit wanneer sy diens van die pryslys verdwyn, of die paneel iets anders onder dieselfde ID begin verkoop. Die ander stappe werk voort, en u word ingelig.
  • ’n Weiering skuif die bestelling aan. Wanneer ’n paneel antwoord en weier, is niks gehef nie, dus word die volgende stap probeer.
  • Geen duidelike antwoord stop dit. ’n Uittelling of ’n gebroke antwoord sê nie of die bestelling bestaan nie. Om dit aan te stuur, kan dit twee keer lewer en hef, dus stop die roete en u gaan daardie een bestelling in u rekening na.
  • Een lopende bestelling per skakel. Terwyl ’n bestelling vir ’n skakel op ’n roete loop, word ’n tweede een vir dieselfde skakel geweier, soos verskaffers self doen.
  • ’n Kansellasie voor lewering kan ook aanbeweeg, as u dit aangeskakel het. Wat ’n gedeeltelike bestelling ongelewer gelaat het, beweeg slegs aan as u daarvoor gevra het.

Foute

FoutWat dit beteken
Invalid API keyDie sleutel is verkeerd, vervang of herroep.
This key is limited to certain addresses…Die versoek het gekom van ’n adres wat nie op die sleutel se lys is nie.
Incorrect requestOnbekend action.
Incorrect service IDGeen roete van u het hierdie ID nie. ’n Roete wat u uitgevee het, behou sy nommer, en dit word nooit aan ’n ander gegee nie.
Incorrect order IDGeen bestelling van u het hierdie nommer nie.
Link is required, Quantity is required’n Veld van add ontbreek of is nie ’n getal nie.
A route takes a link and a quantity onlyDie versoek het geleidelike lewering, kommentaar of ’n ander ekstra veld bevat.
This route is switched offSkakel dit in u rekening aan.
This route already has an order for this link…Wag totdat die lopende een klaar is.
No step of this route can take this order right now. …Elke stap is oorgeslaan voordat iets gestuur is. Die teks noem elke paneel en sy rede.
No step of this route accepted the order. …Elke stap wat gevra is, het geweier. Niks is gehef nie.
Too many requests…Oor die limiet hieronder. Wag ’n minuut.

Voorbeelde

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]);

’n add word altyd binne 30 sekondes beantwoord. ’n Roete kan verskeie verskaffers na mekaar vra; elkeen kry wat van daardie tyd oor is, en ’n verskaffer vir wie nie gewag kon word nie, word glad nie gevra nie. As die laaste een wat gevra is nie geantwoord het wanneer die tyd om is nie, kry u ’n bestelnommer met die status Pending, en die roete stop daar totdat die antwoord bekend is. Die meeste bestellings word binne een of twee sekondes beantwoord.

Limiete en veiligheid

  • 300 versoeke per minuut per sleutel, waarvan 120 bestellings. Tot 100 bestelling-ID’s in een status oproep.
  • Die sleutel word een keer gewys en as ’n vingerafdruk gehou. Nóg u nóg ons kan dit weer lees. As u dit vervang, word die ou een dadelik afgeskakel.
  • Toegelate adresse. Lys u paneel se bedieneradres in u rekening, en die sleutel werk van nêrens anders nie.
  • ’n Roete-ID is nie ’n geheim nie en hoef nie een te wees nie. Dit werk slegs saam met die sleutel van die rekening wat die roete besit.
  • U limiete geld steeds. Die daaglikse limiet van elke paneel, die roete se eie daaglikse limiet en sy grootste bestelling geld vir bestellings wat via die API aankom presies soos vir dié wat u met die hand plaas.
  • Geld gaan nooit deur smm.guide nie. Elke bestelling word betaal uit u saldo op die paneel wat dit neem. Terugbetalings en dispute bly tussen u en daardie paneel.

Wil u eerder die katalogus lees?

Panele, Trust Scores en lewendige pryse het ’n eie API, en ’n MCP-bediener vir assistente.