Domov / Za razvijalce / Orders API

Orders API

Dodajte smm.guide v svoj panel kot ponudnika. Vsaka pot, ki jo ustvarite v svojem računu, je storitev z lastnim ID-jem: vaš panel pošlje naročilo na ta ID, pot pa ga preda prvemu od vaših ponudnikov, ki ga lahko prevzame.

Trije koraki

Oblika je ista, ki jo SMM-paneli že uporabljajo med seboj, zato ni treba ničesar programirati.

1Ustvarite potRačun, Orders desk, Poti. Izberite, kaj izvaja, in dodajte do pet storitev te vrste s panelov, ki ste jih povezali.
2Ustvarite ključOrders desk, Orders API. Ključ je prikazan samo enkrat. Omejite ga lahko na naslov strežnika svojega panela.
3Dodajte ponudnika v svoj panelURL API-ja https://smm.guide/api/v2 in ključ. Uvozite storitve: vaše poti pridejo s svojimi ID-ji, cenami in omejitvami.

Oblika zahteve

Metoda HTTPPOST
URL API-jahttps://smm.guide/api/v2
Teloapplication/x-www-form-urlencoded, ali JSON z Content-Type: application/json. A multipart/form-data telo se prav tako prebere, kar pošlje PHP, ko cURL prejme polje
OdgovorJSON, vedno s HTTP 200, tudi za telo, ki ga ne moremo prebrati, ali za prevelik zahtevek. Napaka je {"error": "…"}
DenarAmeriški dolarji. Cene so na 1.000

Seznam storitev

Vaše poti, ki lahko ta trenutek prevzamejo naročilo. Pot, ki je izklopljena ali so vsi njeni koraki izključeni, ni navedena.

ParameterOpis
keyVaš ključ API
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 najdražji od korakov poti, ki lahko prevzamejo naročilo, vključno s trenutno preskočenimi (panel, ki danes ne deluje, je jutri spet na voljo), zato naročilo nikoli ne stane več od cene, ki jo je uvozil vaš panel. min in max sta najširši meji, ki ju skupaj pokrivajo delujoči koraki; količina, ki ustreza le nekaterim od njih, gre na enega od teh. refill in cancel sta true, ko ju ponuja vsak tak korak.

Pot, ki je izklopljena ali nima nobenega koraka, ki bi lahko deloval, je s tega seznama izpuščena, dokler se ne vrne. Panel, ki storitve sinhronizira samodejno, bo za isti čas pri sebi izklopil to storitev, kar je prav: njena naročila bi bila zavrnjena.

Dodaj naročilo

ParameterOpis
keyVaš ključ API
actionadd
serviceID poti, osem števk
linkPovezava do strani, objave ali profila
quantityPotrebna količina

Odgovor

{
  "order": 23501
}

Nihče ga ni sprejel

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

Številka naročila ostane enaka ves čas trajanja naročila, ne glede na to, kateri ponudnik ga na koncu izvede. Pot sprejme povezavo in količino; postopno dodajanje, komentarji in druga dodatna polja so zavrnjeni.

Status naročila

ParameterOpis
keyVaš ključ API
actionstatus
orderID naročila

Odgovor

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
ParameterOpis
keyVaš ključ API
actionstatus
ordersID-ji naročil, ločeni z vejico, največ 100

Odgovor

{
  "23501": {
    "charge": "0.0045",
    "start_count": "3572",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "99": { "error": "Incorrect order ID" }
}
StatusPomen
PendingSprejel ga je ponudnik, a se še ni začelo. Tudi naročilo, pri katerem ponudnik ni dal jasnega odgovora: pot se tam ustavi, dokler ga ne preverite v svojem računu.
In progress, ProcessingPonudnik ga izvaja ali pa je naročilo na poti do naslednjega koraka.
CompletedIzvedeno v celoti.
PartialDelno izvedeno; remains je količina, ki ni bila izvedena. Šteje, kar so izvedli vsi koraki: ko je en korak izvedel del, preostanek pa je bil preklican na naslednjem, je naročilo Partial, ne Canceled. O vračilu preostanka bremenitve odloča ponudnik.
CanceledNič ni bilo izvedeno in noben drug korak ni prevzel naročila. charge pokaže, kaj je, če sploh kaj, ostalo zaračunano.

charge je znesek, ki so ga ponudniki zaračunali za to naročilo, v dolarjih po tečaju dneva oddaje. start_count pride od ponudnika, ki ga je začel.

Stanje

smm.guide ne hrani vašega denarja. Številka je vsota vaših stanj na panelih za vašimi potmi, v dolarjih.

ParameterOpis
keyVaš ključ API
actionbalance

Odgovor

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

Prekliči

Posreduje se ponudniku, ki ima naročilo zdaj, če njegova storitev omogoča preklic. Naročilo, ki ga prekličete, se nikoli ne pošlje naprej na naslednji korak.

ParameterOpis
keyVaš ključ API
actioncancel
ordersID-ji naročil, ločeni z vejico, največ 100

Odgovor

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

Dopolnitev

Posreduje se ponudniku, ki je naročilo izvedel. Dopolnitev uporablja številko samega naročila.

ParameterOpis
keyVaš ključ API
actionrefill
orderID naročila. Ali orders: več, ločenih z vejico

Odgovor, eno naročilo

{ "refill": "23501" }

Odgovor, več naročil

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
ParameterOpis
keyVaš ključ API
actionrefill_status
refillID dopolnitve. Ali refills: več, ločenih z vejico

Odgovor

{ "status": "Completed" }

Kaj pot naredi z naročilom

  • Koraki se preizkušajo v vašem vrstnem redu ali najprej najcenejši delujoči. Kaj od tega, izberete v poti.
  • Korak se preskoči, ko se njegov panel ne odziva, njegovo stanje ali dnevna omejitev ne pokrije naročila, je količina zunaj obsega, ki ga sprejme, je njegova cena nad omejitvijo, ki ste jo nastavili, ali bi naročilo po njegovi ceni preseglo dnevno omejitev poti. Vrne se sam.
  • Korak izpade, ko njegova storitev izgine s cenika ali panel pod istim ID-jem začne prodajati nekaj drugega. Drugi koraki delujejo naprej, vi pa ste obveščeni.
  • Zavrnitev premakne naročilo naprej. Ko panel odgovori in zavrne, ni bilo nič zaračunano, zato se preizkusi naslednji korak.
  • Nejasen odgovor ga ustavi. Časovna omejitev ali pokvarjen odgovor ne pove, ali naročilo obstaja. Pošiljanje naprej bi ga lahko izvedlo in zaračunalo dvakrat, zato se pot ustavi, vi pa to naročilo preverite v svojem računu.
  • Eno aktivno naročilo na povezavo. Dokler na poti teče naročilo za povezavo, je drugo naročilo za isto povezavo zavrnjeno, tako kot to počnejo ponudniki sami.
  • Tudi preklic pred izvedbo se lahko premakne naprej, če ste to vklopili. Kar delno naročilo ni izvedlo, se premakne naprej le, če ste to zahtevali.

Napake

NapakaKaj pomeni
Invalid API keyKljuč je napačen, zamenjan ali preklican.
This key is limited to certain addresses…Zahteva je prišla z naslova, ki ni na seznamu ključa.
Incorrect requestNeznano action.
Incorrect service IDNobena vaša pot nima tega ID-ja. Izbrisana pot obdrži svojo številko, ki ni nikoli dodeljena drugi.
Incorrect order IDNobeno vaše naročilo nima te številke.
Link is required, Quantity is requiredPolje add manjka ali ni število.
A route takes a link and a quantity onlyZahteva je vsebovala postopno dodajanje, komentarje ali drugo dodatno polje.
This route is switched offVklopite to v svojem računu.
This route already has an order for this link…Počakajte, da se aktivno naročilo konča.
No step of this route can take this order right now. …Vsi koraki so bili preskočeni, preden je bilo karkoli poslano. Besedilo navaja vsak panel in njegov razlog.
No step of this route accepted the order. …Vsi vprašani koraki so zavrnili. Nič ni bilo zaračunano.
Too many requests…Presežena je spodaj navedena omejitev. Počakajte minuto.

Primeri

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 add odgovorimo vedno v 30 sekundah. Pot lahko vpraša več ponudnikov enega za drugim; vsak dobi preostanek tega časa, ponudnika, na katerega ni mogoče počakati, pa sploh ne vpraša. Če zadnji vprašani ob izteku časa ni odgovoril, prejmete številko naročila s statusom Pending, pot pa se tam ustavi, dokler odgovor ni znan. Na večino naročil je odgovor v sekundi ali dveh.

Omejitve in varnost

  • 300 zahtev na minuto na ključ, od tega 120 naročil. Do 100 ID-jev naročil v eni status klic.
  • Ključ je prikazan samo enkrat in shranjen kot prstni odtis. Ne vi ne mi ga ne moremo znova prebrati. Zamenjava takoj izklopi starega.
  • Dovoljeni naslovi. V svojem računu navedite naslov strežnika svojega panela in ključ ne bo deloval nikjer drugje.
  • ID poti ni skrivnost in tudi ni treba, da bi bil. Deluje samo skupaj s ključem računa, ki je lastnik poti.
  • Vaše omejitve še vedno veljajo. Dnevna omejitev vsakega panela, dnevna omejitev poti in njeno največje naročilo veljajo za naročila, ki pridejo prek API-ja, povsem enako kot za tista, ki jih oddate ročno.
  • Denar nikoli ne gre prek smm.guide. Vsako naročilo se plača iz vašega stanja na panelu, ki ga prevzame. Vračila in spori ostanejo med vami in tem panelom.

Želite raje brati katalog?

Paneli, Trust Score in cene v živo imajo svoj API ter strežnik MCP za pomočnike.