Kezdőlap / Fejlesztőknek / Orders API

Orders API

Adja hozzá az smm.guide-ot szolgáltatóként a paneljéhez. Minden útvonal, amelyet a fiókjában létrehoz, egy saját azonosítójú szolgáltatás: a panelje erre az azonosítóra küld rendelést, az útvonal pedig továbbadja az első olyan szolgáltatójának, amely fogadni tudja.

Három lépés

A formátum ugyanaz, amelyet az SMM-panelek már egymás között használnak, így semmit sem kell programozni.

1Hozzon létre útvonalatFiók, Orders desk, Útvonalak. Válassza ki, mit teljesít, és adjon hozzá legfeljebb öt ilyen típusú szolgáltatást a csatlakoztatott paneleiből.
2Hozza létre a kulcsotOrders desk, Orders API. A kulcs csak egyszer jelenik meg. Korlátozhatja a panelje szerverének címére.
3Adjon hozzá szolgáltatót a paneljébenAPI URL https://smm.guide/api/v2 és a kulcs. Importálja a szolgáltatásokat: az útvonalai azonosítóikkal, áraikkal és limitjeikkel együtt érkeznek.

Kérésformátum

HTTP-metódusPOST
API URLhttps://smm.guide/api/v2
Törzsapplication/x-www-form-urlencoded, vagy JSON ezzel: Content-Type: application/json. A multipart/form-data törzset is beolvassuk – ezt küldi a PHP, ha a cURL tömböt kap
VálaszJSON, mindig HTTP 200-zal, akkor is, ha a törzs olvashatatlan, vagy a kérés túl nagy. A hiba formája: {"error": "…"}
PénzUSD. Az árak 1000 darabra vonatkoznak

Szolgáltatáslista

Az útvonalai, amelyek most fogadni tudnak rendelést. A kikapcsolt útvonal, vagy amelynek minden lépése kiesett, nem szerepel a listán.

ParaméterLeírás
keyAz Ön API-kulcsa
actionservices

Válasz

[
  {
    "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 az útvonal azon lépései közül a legdrágább, amelyek fogadhatnak rendelést, a pillanatnyilag kihagyottakat is beleértve (az ma nem működő panel holnap visszatér), így egy rendelés soha nem kerül többe annál az árnál, amelyet a panelje importált. min és max a működő lépések együttesen lefedett legszélesebb határai; az a mennyiség, amely csak némelyikükbe fér bele, azok egyikéhez kerül. refill és cancel akkor igaz, ha minden ilyen lépés kínálja.

A kikapcsolt útvonal, vagy amelynek nincs működőképes lépése, kimarad ebből a listából, amíg vissza nem tér. Az automatikusan szinkronizáló panel ugyanerre az időre a saját oldalán kikapcsolja az adott szolgáltatást, és pontosan ez a cél: a rendeléseit úgyis elutasítanánk.

Rendelés hozzáadása

ParaméterLeírás
keyAz Ön API-kulcsa
actionadd
serviceAz útvonal azonosítója, nyolc számjegy
linkLink az oldalra, bejegyzésre vagy profilra
quantityKért mennyiség

Válasz

{
  "order": 23501
}

Egyik sem fogadta el

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

A rendelésszám a rendelés teljes élettartama alatt ugyanaz marad, bármelyik szolgáltató teljesíti is végül. Az útvonal linket és mennyiséget fogad; a fokozatos adagolást, a kommenteket és más extra mezőket elutasítja.

Rendelés állapota

ParaméterLeírás
keyAz Ön API-kulcsa
actionstatus
orderRendelésazonosító

Válasz

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
ParaméterLeírás
keyAz Ön API-kulcsa
actionstatus
ordersRendelésazonosítók vesszővel elválasztva, legfeljebb 100

Válasz

{
  "23501": {
    "charge": "0.0045",
    "start_count": "3572",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "99": { "error": "Incorrect order ID" }
}
ÁllapotJelentés
PendingEgy szolgáltató elfogadta, de még nem indult el. Ide tartozik az a rendelés is, amelyre egy szolgáltató nem adott egyértelmű választ: az útvonal ott megáll, amíg nem ellenőrizte a fiókjában.
In progress, ProcessingEgy szolgáltató teljesíti, vagy a rendelés úton van a következő lépéshez.
CompletedTeljesen teljesítve.
PartialRészben teljesítve; remains az, ami nem teljesült. Azt számolja, amit az összes lépés teljesített: ha az egyik lépés teljesített egy részt, a maradékot pedig a következőn lemondták, a rendelés állapota Partial, nem Canceled. A terhelés többi részének visszatérítéséről a szolgáltató dönt.
CanceledSemmi sem teljesült, és más lépés sem vette át a rendelést. charge mutatja, maradt-e terhelés, és ha igen, mennyi.

charge az, amit a szolgáltatók ezért a rendelésért felszámítottak, dollárban, a leadás napjának árfolyamán. start_count attól a szolgáltatótól származik, amelyik elindította.

Egyenleg

Az smm.guide nem tart Önnek pénzt. Az összeg az útvonalai mögötti paneleken lévő egyenlegeinek összege, dollárban.

ParaméterLeírás
keyAz Ön API-kulcsa
actionbalance

Válasz

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

Mégse

Továbbítjuk annak a szolgáltatónak, amelyiknél a rendelés most van, ha a szolgáltatása kínál lemondást. A lemondott rendelést soha nem küldjük tovább a következő lépésre.

ParaméterLeírás
keyAz Ön API-kulcsa
actioncancel
ordersRendelésazonosítók vesszővel elválasztva, legfeljebb 100

Válasz

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

Utántöltés

Továbbítjuk annak a szolgáltatónak, amelyik teljesítette a rendelést. Az utántöltés a rendelés saját számát viseli.

ParaméterLeírás
keyAz Ön API-kulcsa
actionrefill
orderRendelésazonosító. Vagy orders: több is, vesszővel elválasztva

Válasz, egy rendelés

{ "refill": "23501" }

Válasz, több rendelés

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
ParaméterLeírás
keyAz Ön API-kulcsa
actionrefill_status
refillUtántöltés-azonosító. Vagy refills: több is, vesszővel elválasztva

Válasz

{ "status": "Completed" }

Mit tesz az útvonal egy rendeléssel

  • A lépéseket az Ön sorrendjében próbáljuk, vagy a legolcsóbb működővel kezdve. Hogy melyik legyen, azt az útvonalban választja ki.
  • Egy lépést kihagyunk, ha a panelje nem válaszol, az egyenlege vagy napi limitje nem fedezi a rendelést, a mennyiség kívül esik azon, amit fogad, az ára meghaladja az Ön által beállított limitet, vagy azon az áron a rendelés túllépné az útvonal saját napi limitjét. Magától visszatér.
  • Egy lépés kiesik, ha a szolgáltatása lekerül az árlistáról, vagy a panel ugyanazon az azonosítón valami mást kezd árulni. A többi lépés tovább működik, és értesítjük.
  • Az elutasítás továbbviszi a rendelést. Ha egy panel válaszol és elutasít, nem történt terhelés, így a következő lépést próbáljuk.
  • A bizonytalan válasz megállítja. Az időtúllépés vagy a hibás válasz nem árulja el, hogy létezik-e a rendelés. A továbbküldés kétszeres teljesítést és terhelést okozhatna, ezért az útvonal megáll, és Ön ellenőrzi azt az egy rendelést a fiókjában.
  • Linkenként egy futó rendelés. Amíg egy linkre szóló rendelés fut egy útvonalon, az ugyanarra a linkre szóló második rendelést elutasítjuk, ahogy a szolgáltatók is teszik.
  • A teljesítés előtti lemondás is továbbléphet, ha ezt bekapcsolta. A részleges rendelés teljesítetlen maradéka csak akkor lép tovább, ha ezt kérte.

Hibák

HibaMit jelent
Invalid API keyA kulcs hibás, lecserélték vagy visszavonták.
This key is limited to certain addresses…A kérés olyan címről érkezett, amely nem szerepel a kulcs listáján.
Incorrect requestIsmeretlen action.
Incorrect service IDEgyetlen útvonalának sincs ilyen azonosítója. A törölt útvonal megtartja a számát, és azt soha nem kapja meg más.
Incorrect order IDEgyetlen rendelésének sincs ilyen száma.
Link is required, Quantity is requiredA következő kérés egy mezője: add – hiányzik, vagy nem szám.
A route takes a link and a quantity onlyA kérés fokozatos adagolást, kommenteket vagy más extra mezőt tartalmazott.
This route is switched offKapcsolja be a fiókjában.
This route already has an order for this link…Várja meg, amíg a futó rendelés befejeződik.
No step of this route can take this order right now. …Minden lépést kihagytunk, mielőtt bármit elküldtünk volna. A szöveg megnevezi az egyes paneleket és az okot.
No step of this route accepted the order. …Minden megkérdezett lépés elutasította. Nem történt terhelés.
Too many requests…Túllépte az alábbi limitet. Várjon egy percet.

Példák

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

Egy add hívásra mindig 30 másodpercen belül válaszolunk. Az útvonal egymás után több szolgáltatót is megkérdezhet; mindegyik az ebből az időből hátralévő részt kapja, és azt a szolgáltatót, amelyre már nem lehetne kivárni, meg sem kérdezzük. Ha a legutoljára megkérdezett nem válaszolt, mire lejár az idő, Pending állapotú rendelésszámot kap, és az útvonal ott megáll, amíg a válasz ki nem derül. A legtöbb rendelésre egy-két másodperc alatt jön válasz.

Limitek és biztonság

  • Kulcsonként percenként 300 kérés, ebből 120 rendelés. Egyszerre legfeljebb 100 rendelésazonosító status hívás.
  • A kulcs egyszer jelenik meg, és ujjlenyomatként tároljuk. Sem Ön, sem mi nem tudjuk újra elolvasni. Cseréjekor a régi azonnal érvénytelenné válik.
  • Engedélyezett címek. Adja meg a fiókjában a panelje szerverének címét, és a kulcs máshonnan nem működik.
  • Az útvonal azonosítója nem titok, és nem is kell annak lennie. Csak az útvonalat birtokló fiók kulcsával együtt működik.
  • A limitjei továbbra is érvényesek. Az egyes panelek napi limitje, az útvonal saját napi limitje és legnagyobb rendelése pontosan ugyanúgy vonatkozik az API-n érkező rendelésekre, mint a kézzel leadottakra.
  • A pénz soha nem megy át az smm.guide-on. Minden rendelést annak a panelnek az egyenlegéből fizet, amelyik fogadja. A visszatérítések és a vitás ügyek Ön és az adott panel között maradnak.

Inkább a katalógust olvasná?

A paneleknek, a Trust Score-oknak és az élő áraknak saját API-juk van, valamint MCP-szerver asszisztenseknek.