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.
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 metoda | POST |
| API URL | https://smm.guide/api/v2 |
| Tijelo | application/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 |
| Odgovor | JSON, uvijek s HTTP 200, i za tijelo koje ne možemo pročitati ili za prevelik zahtjev. Pogreška je {"error": "…"} |
| Novac | Američ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.
| Parametar | Opis |
|---|---|
key | Vaš API ključ |
action | services |
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
| Parametar | Opis |
|---|---|
key | Vaš API ključ |
action | add |
service | ID rute, osam znamenki |
link | Poveznica na stranicu, objavu ili profil |
quantity | Potrebna 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
| Parametar | Opis |
|---|---|
key | Vaš API ključ |
action | status |
order | ID narudžbe |
Odgovor
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| Parametar | Opis |
|---|---|
key | Vaš API ključ |
action | status |
orders | ID-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" }
}| Status | Značenje |
|---|---|
Pending | Dobavljač 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, Processing | Dobavljač je isporučuje ili je narudžba na putu do sljedećeg koraka. |
Completed | Isporučeno u cijelosti. |
Partial | Djelomič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č. |
Canceled | Niš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.
| Parametar | Opis |
|---|---|
key | Vaš API ključ |
action | balance |
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.
| Parametar | Opis |
|---|---|
key | Vaš API ključ |
action | cancel |
orders | ID-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.
| Parametar | Opis |
|---|---|
key | Vaš API ključ |
action | refill |
order | ID narudžbe. Ili orders: nekoliko, odvojenih zarezom |
Odgovor, jedna narudžba
{ "refill": "23501" }
Odgovor, nekoliko
[
{ "order": 23501, "refill": 23501 },
{ "order": 23502, "refill": { "error": "…" } }
]| Parametar | Opis |
|---|---|
key | Vaš API ključ |
action | refill_status |
refill | ID 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 key | Ključ 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 request | Nepoznato action. |
Incorrect service ID | Nijedna vaša ruta nema ovaj ID. Ruta koju ste izbrisali zadržava svoj broj i on se nikad ne dodjeljuje drugoj. |
Incorrect order ID | Nijedna vaša narudžba nema ovaj broj. |
Link is required, Quantity is required | Polje za add nedostaje ili nije broj. |
A route takes a link and a quantity only | Zahtjev je sadržavao postupnu isporuku, komentare ili drugo dodatno polje. |
This route is switched off | Uključ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
statuspoziv. - 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.