Početna / Za programere / Orders API

Orders API

Dodajte smm.guide u svoj panel kao dobavljača. Svaka ruta koju izradite u svom računu usluga je s vlastitim ID-om: vaš panel šalje narudžbu na taj ID, a ruta je prosljeđuje prvom od vaših dobavljača koji je može preuzeti.

Tri koraka

Format je onaj koji SMM paneli već koriste međusobno pa ništa ne treba programirati.

1Izradite rutuRačun, Orders desk, Rute. Odaberite što isporučuje i dodajte do pet usluga te vrste s panela koje ste povezali.
2Izradite ključOrders desk, Orders API. Ključ se prikazuje jednom. Možete ga ograničiti na adresu poslužitelja svog panela.
3Dodajte dobavljača u svoj panelAPI URL https://smm.guide/api/v2 i ključ. Uvezite usluge: vaše rute stižu sa svojim ID-ovima, cijenama i ograničenjima.

Format zahtjeva

HTTP metodaPOST
API URLhttps://smm.guide/api/v2
Tijeloapplication/x-www-form-urlencoded, ili JSON s Content-Type: application/json. A multipart/form-data tijelo također se čita, a to PHP šalje kada se cURL-u preda polje
OdgovorJSON, uvijek s HTTP 200, i za tijelo koje ne možemo pročitati ili za prevelik zahtjev. Pogreška je {"error": "…"}
NovacAmerički dolari. Cijene su za 1.000

Popis usluga

Vaše rute koje trenutačno mogu preuzeti narudžbu. Ruta koja je isključena ili kojoj su svi koraci ispali nije navedena.

ParametarOpis
keyVaš API ključ
actionservices

Odgovor

[
  {
    "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 je najskuplji od koraka rute koji mogu preuzeti narudžbu, uključujući one koji se trenutačno preskaču (panel koji danas ne radi sutra se vraća), pa narudžba nikad ne košta više od cijene koju je vaš panel uvezao. min i max su najširi raspon koji ispravni koraci zajedno pokrivaju; količina koja odgovara samo nekima od njih ide jednom od tih koraka. refill i cancel imaju vrijednost true kada ih nudi svaki takav korak.

Ruta koja je isključena ili nema nijedan korak koji može raditi izostavlja se s ovog popisa dok se ne vrati. Panel koji automatski sinkronizira svoje usluge isključit će tu uslugu na svojoj strani za isto vrijeme, a to je ono što želite: njegove bi narudžbe bile odbijene.

Dodaj narudžbu

ParametarOpis
keyVaš API ključ
actionadd
serviceID rute, osam znamenki
linkPoveznica na stranicu, objavu ili profil
quantityPotrebna količina

Odgovor

{
  "order": 23501
}

Nitko je nije prihvatio

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

Broj narudžbe ostaje isti tijekom cijelog životnog vijeka narudžbe, bez obzira na to koji je dobavljač na kraju isporuči. Ruta prima poveznicu i količinu; postupna isporuka, komentari i ostala dodatna polja odbijaju se.

Status narudžbe

ParametarOpis
keyVaš API ključ
actionstatus
orderID narudžbe

Odgovor

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
ParametarOpis
keyVaš API ključ
actionstatus
ordersID-ovi narudžbi odvojeni zarezom, do 100

Odgovor

{
  "23501": {
    "charge": "0.0045",
    "start_count": "3572",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "99": { "error": "Incorrect order ID" }
}
StatusZnačenje
PendingDobavljač ju je prihvatio, ali još nije pokrenuta. Također narudžba na kojoj dobavljač nije dao jasan odgovor: ruta se ondje zaustavlja dok je ne provjerite u svom računu.
In progress, ProcessingDobavljač je isporučuje ili je narudžba na putu do sljedećeg koraka.
CompletedIsporučeno u cijelosti.
PartialDjelomično isporučeno; remains označava ono što nije isporučeno. Računa se ono što je isporučio svaki korak: kada je jedan korak isporučio dio, a ostatak je otkazan na sljedećem, narudžba je Djelomično, a ne Otkazano. O povratu ostatka naplate odlučuje dobavljač.
CanceledNišta nije isporučeno i nijedan drugi korak nije preuzeo narudžbu. charge pokazuje što je, ako išta, ostalo naplaćeno.

charge je ono što su dobavljači naplatili za ovu narudžbu, u dolarima po tečaju na dan narudžbe. start_count dolazi od dobavljača koji ju je pokrenuo.

Stanje

smm.guide ne drži vaš novac. Iznos je zbroj vaših stanja na panelima iza vaših ruta, u dolarima.

ParametarOpis
keyVaš API ključ
actionbalance

Odgovor

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

Odustani

Prosljeđuje se dobavljaču koji trenutačno drži narudžbu, ako njegova usluga nudi otkazivanje. Narudžba koju otkažete nikad se ne šalje dalje na sljedeći korak.

ParametarOpis
keyVaš API ključ
actioncancel
ordersID-ovi narudžbi odvojeni zarezom, do 100

Odgovor

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

Dopuna

Prosljeđuje se dobavljaču koji je isporučio narudžbu. Dopuna nosi broj same narudžbe.

ParametarOpis
keyVaš API ključ
actionrefill
orderID narudžbe. Ili orders: nekoliko, odvojenih zarezom

Odgovor, jedna narudžba

{ "refill": "23501" }

Odgovor, nekoliko

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
ParametarOpis
keyVaš API ključ
actionrefill_status
refillID dopune. Ili refills: nekoliko, odvojenih zarezom

Odgovor

{ "status": "Completed" }

Što ruta radi s narudžbom

  • Koraci se isprobavaju vašim redoslijedom ili prvo najjeftiniji ispravni. Način birate u ruti.
  • Korak se preskače kada njegov panel ne odgovara, njegovo stanje ili dnevni limit ne pokriva narudžbu, količina je izvan onoga što prima, cijena mu je iznad limita koji ste postavili ili bi po njegovoj cijeni narudžba premašila vlastiti dnevni limit rute. Vraća se sam.
  • Korak ispada kada njegova usluga nestane iz cjenika ili panel pod istim ID-om počne prodavati nešto drugo. Ostali koraci nastavljaju raditi, a vi dobivate obavijest.
  • Odbijanje prosljeđuje narudžbu dalje. Kada panel odgovori i odbije, ništa nije naplaćeno pa se isprobava sljedeći korak.
  • Nejasan odgovor je zaustavlja. Istek vremena ili neispravan odgovor ne govore postoji li narudžba. Slanje dalje moglo bi je isporučiti i naplatiti dvaput pa se ruta zaustavlja, a vi tu narudžbu provjeravate u svom računu.
  • Jedna aktivna narudžba po poveznici. Dok je narudžba za neku poveznicu aktivna na ruti, druga za istu poveznicu se odbija, kao što to rade i sami dobavljači.
  • I otkazivanje prije isporuke može se proslijediti dalje, ako ste to uključili. Ono što djelomična narudžba nije isporučila prosljeđuje se dalje samo ako ste to zatražili.

Pogreške

PogreškaŠto znači
Invalid API keyKljuč je pogrešan, zamijenjen ili opozvan.
This key is limited to certain addresses…Zahtjev je stigao s adrese koja nije na popisu ključa.
Incorrect requestNepoznato action.
Incorrect service IDNijedna vaša ruta nema ovaj ID. Ruta koju ste izbrisali zadržava svoj broj i on se nikad ne dodjeljuje drugoj.
Incorrect order IDNijedna vaša narudžba nema ovaj broj.
Link is required, Quantity is requiredPolje za add nedostaje ili nije broj.
A route takes a link and a quantity onlyZahtjev je sadržavao postupnu isporuku, komentare ili drugo dodatno polje.
This route is switched offUključite to u svom računu.
This route already has an order for this link…Pričekajte da aktivna narudžba završi.
No step of this route can take this order right now. …Svaki je korak preskočen prije nego što je išta poslano. Tekst navodi svaki panel i njegov razlog.
No step of this route accepted the order. …Svaki upitani korak je odbio. Ništa nije naplaćeno.
Too many requests…Prekoračen je limit naveden u nastavku. Pričekajte minutu.

Primjeri

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

Na zahtjev add uvijek odgovaramo u roku od 30 sekundi. Ruta može pitati nekoliko dobavljača jednog za drugim; svaki dobiva ostatak tog vremena, a dobavljač kojeg se ne bi moglo pričekati uopće se ne pita. Ako zadnji upitani nije odgovorio kada vrijeme istekne, dobivate broj narudžbe sa statusom Na čekanju, a ruta se ondje zaustavlja dok odgovor ne bude poznat. Većina narudžbi dobije odgovor za jednu ili dvije sekunde.

Ograničenja i sigurnost

  • 300 zahtjeva u minuti po ključu, od toga 120 narudžbi. Do 100 ID-ova narudžbi u jednom status poziv.
  • Ključ se prikazuje jednom i čuva se kao otisak. Ni vi ni mi ga ne možemo ponovno pročitati. Zamjenom se stari ključ odmah isključuje.
  • Dopuštene adrese. Navedite adresu poslužitelja svog panela u svom računu i ključ neće raditi ni s jednog drugog mjesta.
  • ID rute nije tajna i ne mora biti. Radi samo zajedno s ključem računa kojem ruta pripada.
  • Vaša ograničenja i dalje vrijede. Dnevni limit svakog panela, vlastiti dnevni limit rute i njezina najveća narudžba primjenjuju se na narudžbe koje stižu putem API-ja jednako kao i na one koje unosite ručno.
  • Novac nikad ne prolazi kroz smm.guide. Svaka se narudžba plaća s vašeg stanja na panelu koji je preuzme. Povrati i sporovi ostaju između vas i tog panela.

Želite li umjesto toga čitati katalog?

Paneli, njihov Trust Score i cijene uživo imaju vlastiti API te MCP poslužitelj za asistente.