Domov / Pre vývojárov / Orders API
Orders API
Pridajte smm.guide do svojho panelu ako poskytovateľa. Každá trasa, ktorú si vo svojom účte vytvoríte, je služba s vlastným ID: váš panel pošle objednávku na toto ID a trasa ju odovzdá prvému z vašich poskytovateľov, ktorý ju môže prijať.
Tri kroky
Formát je ten, ktorý SMM panely medzi sebou už používajú, takže nie je čo programovať.
https://smm.guide/api/v2 a kľúč. Importujte služby: vaše trasy prídu so svojimi ID, cenami a limitmi.Formát požiadavky
| HTTP metóda | POST |
| API URL | https://smm.guide/api/v2 |
| Telo | application/x-www-form-urlencoded, alebo JSON s Content-Type: application/json. A multipart/form-data telo sa číta tiež, čo PHP posiela, keď cURL dostane pole |
| Odpoveď | JSON, vždy s HTTP 200, aj pre telo, ktoré nevieme prečítať, alebo príliš veľkú požiadavku. Chyba je {"error": "…"} |
| Peniaze | Americké doláre. Ceny sú za 1 000 |
Zoznam služieb
Vaše trasy, ktoré môžu práve teraz prijať objednávku. Trasa, ktorá je vypnutá alebo ktorej všetky kroky sú vyradené, sa neuvádza.
| Parameter | Popis |
|---|---|
key | Váš API kľúč |
action | services |
Odpoveď
[
{
"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 najdrahší z krokov trasy, ktoré môžu prijať objednávku, vrátane momentálne preskočených (panel, ktorý dnes nefunguje, zajtra funguje), takže objednávka nikdy nestojí viac ako cena, ktorú váš panel importoval. min a max sú najširšie, aké spolu pokrývajú funkčné kroky; množstvo, ktoré sa zmestí len do niektorých z nich, ide na jeden z nich. refill a cancel sú true, keď ich ponúka každý taký krok.
Trasa, ktorá je vypnutá alebo nemá žiadny krok, ktorý môže fungovať, je z tohto zoznamu vynechaná, kým sa nevráti. Panel, ktorý synchronizuje svoje služby automaticky, túto službu na svojej strane na rovnaký čas vypne, čo je presne to, čo chcete: jej objednávky by boli odmietnuté.
Pridať objednávku
| Parameter | Popis |
|---|---|
key | Váš API kľúč |
action | add |
service | ID trasy, osem číslic |
link | Odkaz na stránku, príspevok alebo profil |
quantity | Požadované množstvo |
Odpoveď
{
"order": 23501
}
Nikto ju neprijal
{
"error": "No step of this route accepted the order. …"
}Číslo objednávky zostáva rovnaké počas celej jej existencie bez ohľadu na to, ktorý poskytovateľ ju nakoniec dodá. Trasa prijíma odkaz a množstvo; postupné dodávanie, komentáre a ďalšie polia sa odmietajú.
Stav objednávky
| Parameter | Popis |
|---|---|
key | Váš API kľúč |
action | status |
order | ID objednávky |
Odpoveď
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| Parameter | Popis |
|---|---|
key | Váš API kľúč |
action | status |
orders | ID objednávok oddelené čiarkou, najviac 100 |
Odpoveď
{
"23501": {
"charge": "0.0045",
"start_count": "3572",
"status": "Completed",
"remains": "0",
"currency": "USD"
},
"99": { "error": "Incorrect order ID" }
}| Stav | Význam |
|---|---|
Pending | Prijatá poskytovateľom a zatiaľ nespustená. Aj objednávka, ku ktorej poskytovateľ nedal jasnú odpoveď: trasa tam zastaví, kým ju neskontrolujete vo svojom účte. |
In progress, Processing | Poskytovateľ ju dodáva alebo je objednávka na ceste k ďalšiemu kroku. |
Completed | Dodaná celá. |
Partial | Dodaná čiastočne; remains je to, čo dodané nebolo. Započítava sa to, čo dodal každý krok: keď jeden krok dodal časť a zvyšok sa na ďalšom zrušil, objednávka je Partial, nie Canceled. O vrátení zvyšku platby rozhoduje poskytovateľ. |
Canceled | Nič sa nedodalo a objednávku neprevzal žiadny iný krok. charge ukazuje, čo zostalo strhnuté, ak vôbec niečo. |
charge je suma, ktorú poskytovatelia za túto objednávku strhli, v dolároch podľa kurzu dňa, keď bola zadaná. start_count pochádza od poskytovateľa, ktorý ju spustil.
Zostatok
smm.guide nedrží žiadne vaše peniaze. Údaj je súčtom vašich zostatkov v paneloch za vašimi trasami, v dolároch.
| Parameter | Popis |
|---|---|
key | Váš API kľúč |
action | balance |
Odpoveď
{
"balance": "126.1375",
"currency": "USD"
}Zrušiť
Odovzdá sa poskytovateľovi, ktorý objednávku práve drží, ak jeho služba ponúka zrušenie. Objednávka, ktorú zrušíte, sa nikdy nepošle na ďalší krok.
| Parameter | Popis |
|---|---|
key | Váš API kľúč |
action | cancel |
orders | ID objednávok oddelené čiarkou, najviac 100 |
Odpoveď
[
{ "order": 23501, "cancel": 1 },
{ "order": 23502, "cancel": { "error": "The order is already finished" } }
]Doplnenie
Odovzdá sa poskytovateľovi, ktorý objednávku dodal. Doplnenie nesie vlastné číslo objednávky.
| Parameter | Popis |
|---|---|
key | Váš API kľúč |
action | refill |
order | ID objednávky. Alebo orders: viacero, oddelených čiarkou |
Odpoveď, jedna objednávka
{ "refill": "23501" }
Odpoveď, viacero
[
{ "order": 23501, "refill": 23501 },
{ "order": 23502, "refill": { "error": "…" } }
]| Parameter | Popis |
|---|---|
key | Váš API kľúč |
action | refill_status |
refill | ID doplnenia. Alebo refills: viacero, oddelených čiarkou |
Odpoveď
{ "status": "Completed" }Čo trasa robí s objednávkou
- Kroky sa skúšajú vo vašom poradí, alebo najprv najlacnejší funkčný. Ktorý spôsob, si vyberiete v trase.
- Krok sa preskočí, keď jeho panel neodpovedá, jeho zostatok alebo denný limit nepokryje objednávku, množstvo je mimo jeho rozsahu, jeho cena je nad vami nastaveným limitom alebo by pri jeho cene objednávka prekročila denný limit trasy. Vráti sa sám.
- Krok vypadne, keď jeho služba zmizne z cenníka alebo panel začne pod rovnakým ID predávať niečo iné. Ostatné kroky fungujú ďalej a dostanete upozornenie.
- Odmietnutie posunie objednávku ďalej. Keď panel odpovie a odmietne, nič sa nestrhlo, preto sa skúsi ďalší krok.
- Nejasná odpoveď ju zastaví. Vypršanie času alebo poškodená odpoveď nepovie, či objednávka existuje. Jej poslanie ďalej by ju mohlo dodať a strhnúť dvakrát, preto sa trasa zastaví a vy túto jednu objednávku skontrolujete vo svojom účte.
- Jedna bežiaca objednávka na odkaz. Kým na trase beží objednávka pre určitý odkaz, druhá pre rovnaký odkaz sa odmietne, ako to robia aj samotní poskytovatelia.
- Ďalej sa môže posunúť aj zrušenie pred dodaním, ak ste to zapli. To, čo čiastočná objednávka nedodala, sa posunie ďalej, iba ak ste o to požiadali.
Chyby
| Chyba | Čo znamená |
|---|---|
Invalid API key | Kľúč je nesprávny, nahradený alebo odvolaný. |
This key is limited to certain addresses… | Požiadavka prišla z adresy, ktorá nie je v zozname kľúča. |
Incorrect request | Neznáme action. |
Incorrect service ID | Žiadna vaša trasa nemá toto ID. Odstránená trasa si ponecháva svoje číslo a nikdy sa nepridelí inej. |
Incorrect order ID | Žiadna vaša objednávka nemá toto číslo. |
Link is required, Quantity is required | Pole add chýba alebo nie je číslo. |
A route takes a link and a quantity only | Požiadavka obsahovala postupné dodávanie, komentáre alebo iné ďalšie pole. |
This route is switched off | Zapnite to vo svojom účte. |
This route already has an order for this link… | Počkajte, kým bežiaca objednávka skončí. |
No step of this route can take this order right now. … | Každý krok bol preskočený skôr, než sa niečo odoslalo. Text uvádza každý panel a jeho dôvod. |
No step of this route accepted the order. … | Každý oslovený krok odmietol. Nič sa nestrhlo. |
Too many requests… | Nad limitom uvedeným nižšie. Počkajte minútu. |
Príklady
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 požiadavku add sa vždy odpovie do 30 sekúnd. Trasa sa môže pýtať viacerých poskytovateľov po sebe; každý dostane zvyšok tohto času a poskytovateľ, na ktorého by sa nedalo počkať, sa vôbec neosloví. Ak posledný oslovený neodpovie do uplynutia času, dostanete číslo objednávky so stavom Pending a trasa tam zastaví, kým nebude odpoveď známa. Väčšina objednávok dostane odpoveď za jednu až dve sekundy.
Limity a bezpečnosť
- 300 požiadaviek za minútu na kľúč, z toho 120 objednávok. Až 100 ID objednávok v jednej
statusvolanie. - Kľúč sa zobrazí raz a uchováva sa ako odtlačok. Ani vy, ani my ho už nemôžeme prečítať. Jeho nahradením sa starý okamžite vypne.
- Povolené adresy. Uveďte vo svojom účte adresu servera svojho panelu a kľúč nebude fungovať odinakiaľ.
- ID trasy nie je tajomstvo a nemusí ním byť. Funguje iba spolu s kľúčom účtu, ktorému trasa patrí.
- Vaše limity stále platia. Denný limit každého panelu, denný limit trasy a jej najväčšia objednávka platia pre objednávky prichádzajúce cez API presne tak ako pre tie, ktoré zadáte ručne.
- Peniaze nikdy neprechádzajú cez smm.guide. Každá objednávka sa platí z vášho zostatku v paneli, ktorý ju prevezme. Vrátenia peňazí a spory zostávajú medzi vami a týmto panelom.
Chcete radšej čítať katalóg?
Panely, Trust Score a aktuálne ceny majú vlastné API a MCP server pre asistentov.