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.
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ódus | POST |
| API URL | https://smm.guide/api/v2 |
| Törzs | application/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álasz | JSON, 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énz | USD. 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éter | Leírás |
|---|---|
key | Az Ön API-kulcsa |
action | services |
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éter | Leírás |
|---|---|
key | Az Ön API-kulcsa |
action | add |
service | Az útvonal azonosítója, nyolc számjegy |
link | Link az oldalra, bejegyzésre vagy profilra |
quantity | Ké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éter | Leírás |
|---|---|
key | Az Ön API-kulcsa |
action | status |
order | Rendelésazonosító |
Válasz
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| Paraméter | Leírás |
|---|---|
key | Az Ön API-kulcsa |
action | status |
orders | Rendelé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" }
}| Állapot | Jelentés |
|---|---|
Pending | Egy 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, Processing | Egy szolgáltató teljesíti, vagy a rendelés úton van a következő lépéshez. |
Completed | Teljesen teljesítve. |
Partial | Ré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. |
Canceled | Semmi 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éter | Leírás |
|---|---|
key | Az Ön API-kulcsa |
action | balance |
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éter | Leírás |
|---|---|
key | Az Ön API-kulcsa |
action | cancel |
orders | Rendelé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éter | Leírás |
|---|---|
key | Az Ön API-kulcsa |
action | refill |
order | Rendelé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éter | Leírás |
|---|---|
key | Az Ön API-kulcsa |
action | refill_status |
refill | Utá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
| Hiba | Mit jelent |
|---|---|
Invalid API key | A 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 request | Ismeretlen action. |
Incorrect service ID | Egyetlen ú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 ID | Egyetlen rendelésének sincs ilyen száma. |
Link is required, Quantity is required | A következő kérés egy mezője: add – hiányzik, vagy nem szám. |
A route takes a link and a quantity only | A kérés fokozatos adagolást, kommenteket vagy más extra mezőt tartalmazott. |
This route is switched off | Kapcsolja 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ó
statushí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.