Domů / Pro vývojáře / Orders API
Orders API
Přidejte smm.guide do svého panelu jako poskytovatele. Každá trasa, kterou si v účtu vytvoříte, je služba s vlastním ID: váš panel pošle objednávku na toto ID a trasa ji předá prvnímu z vašich poskytovatelů, který ji může převzít.
Tři kroky
Formát je ten, který SMM panely už mezi sebou používají, takže není co programovat.
https://smm.guide/api/v2 a klíč. Importujte služby: vaše trasy dorazí se svými ID, cenami a limity.Formát požadavku
| Metoda HTTP | POST |
| URL API | https://smm.guide/api/v2 |
| Tělo | application/x-www-form-urlencoded, nebo JSON s Content-Type: application/json. A multipart/form-data tělo se čte také; právě to posílá PHP, když cURL předáte pole |
| Odpověď | JSON, vždy s HTTP 200, i pro tělo, které nedokážeme přečíst, nebo pro příliš velký požadavek. Chyba je {"error": "…"} |
| Peníze | Americké dolary. Ceny jsou za 1 000 |
Seznam služeb
Vaše trasy, které mohou právě teď převzít objednávku. Trasa, která je vypnutá nebo má všechny kroky vyřazené, se neuvádí.
| Parametr | Popis |
|---|---|
key | Váš klíč API |
action | services |
Odpověď
[
{
"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 nejdražší z kroků trasy, které mohou převzít objednávku, včetně dočasně přeskočených (panel, který dnes nefunguje, je zítra zpět), takže objednávka nikdy nestojí víc než cena, kterou váš panel importoval. min a max jsou nejširší rozsah, který funkční kroky společně pokrývají; množství, které vyhovuje jen některým z nich, jde na jeden z nich. refill a cancel mají hodnotu true, když je nabízí každý takový krok.
Trasa, která je vypnutá nebo nemá žádný krok, který by mohl fungovat, je z tohoto seznamu vynechána, dokud se nevrátí. Panel, který synchronizuje služby automaticky, tuto službu na své straně na stejnou dobu vypne, a to je správně: jeho objednávky by byly odmítnuty.
Přidat objednávku
| Parametr | Popis |
|---|---|
key | Váš klíč API |
action | add |
service | ID trasy, osm číslic |
link | Odkaz na stránku, příspěvek nebo profil |
quantity | Požadované množství |
Odpověď
{
"order": 23501
}
Nikdo ji nepřijal
{
"error": "No step of this route accepted the order. …"
}Číslo objednávky zůstává stejné po celou dobu jejího trvání, ať ji nakonec doručí kterýkoli poskytovatel. Trasa přijímá odkaz a množství; postupné dodávání, komentáře a další pole se odmítají.
Stav objednávky
| Parametr | Popis |
|---|---|
key | Váš klíč API |
action | status |
order | ID objednávky |
Odpověď
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| Parametr | Popis |
|---|---|
key | Váš klíč API |
action | status |
orders | ID objednávek oddělená čárkou, nejvýše 100 |
Odpověď
{
"23501": {
"charge": "0.0045",
"start_count": "3572",
"status": "Completed",
"remains": "0",
"currency": "USD"
},
"99": { "error": "Incorrect order ID" }
}| Stav | Význam |
|---|---|
Pending | Přijata poskytovatelem a ještě nezahájena. Také objednávka, ke které poskytovatel nedal jasnou odpověď: trasa se u ní zastaví, dokud ji nezkontrolujete ve svém účtu. |
In progress, Processing | Poskytovatel ji doručuje, nebo je objednávka na cestě k dalšímu kroku. |
Completed | Doručena celá. |
Partial | Doručena částečně; remains je to, co doručeno nebylo. Počítá se, co doručily všechny kroky: když jeden krok doručil část a zbytek byl na dalším zrušen, objednávka je Partial, ne Canceled. O vrácení zbytku platby rozhoduje poskytovatel. |
Canceled | Nic nebylo doručeno a žádný jiný krok objednávku nepřevzal. charge ukazuje, co případně zůstalo účtováno. |
charge je částka, kterou poskytovatelé za tuto objednávku účtovali, v dolarech podle kurzu dne, kdy byla zadána. start_count pochází od poskytovatele, který ji zahájil.
Zůstatek
smm.guide nedrží žádné vaše peníze. Údaj je součtem vašich zůstatků na panelech za vašimi trasami, v dolarech.
| Parametr | Popis |
|---|---|
key | Váš klíč API |
action | balance |
Odpověď
{
"balance": "126.1375",
"currency": "USD"
}Zrušit
Předá se poskytovateli, který objednávku právě drží, pokud jeho služba nabízí zrušení. Objednávka, kterou zrušíte, se na další krok nikdy neposílá.
| Parametr | Popis |
|---|---|
key | Váš klíč API |
action | cancel |
orders | ID objednávek oddělená čárkou, nejvýše 100 |
Odpověď
[
{ "order": 23501, "cancel": 1 },
{ "order": 23502, "cancel": { "error": "The order is already finished" } }
]Doplnění
Předá se poskytovateli, který objednávku doručil. Doplnění nese vlastní číslo objednávky.
| Parametr | Popis |
|---|---|
key | Váš klíč API |
action | refill |
order | ID objednávky. Nebo orders: několik, oddělených čárkou |
Odpověď, jedna objednávka
{ "refill": "23501" }
Odpověď, několik
[
{ "order": 23501, "refill": 23501 },
{ "order": 23502, "refill": { "error": "…" } }
]| Parametr | Popis |
|---|---|
key | Váš klíč API |
action | refill_status |
refill | ID doplnění. Nebo refills: několik, oddělených čárkou |
Odpověď
{ "status": "Completed" }Co trasa dělá s objednávkou
- Kroky se zkoušejí ve vašem pořadí, nebo nejdřív ten nejlevnější funkční. Co z toho, volíte v trase.
- Krok se přeskočí, když jeho panel neodpovídá, jeho zůstatek nebo denní limit objednávku nepokryje, množství je mimo jeho rozsah, jeho cena je nad limitem, který jste nastavili, nebo by objednávka za jeho cenu překročila denní limit trasy. Vrátí se sám.
- Krok se vyřadí, když jeho služba zmizí z ceníku nebo panel začne pod stejným ID prodávat něco jiného. Ostatní kroky fungují dál a dostanete upozornění.
- Odmítnutí posune objednávku dál. Když panel odpoví a odmítne, nic nebylo účtováno, takže se zkusí další krok.
- Nejasná odpověď ji zastaví. Vypršení časového limitu nebo poškozená odpověď neříká, zda objednávka existuje. Předání dál by ji mohlo doručit a naúčtovat dvakrát, takže se trasa zastaví a vy tu jednu objednávku zkontrolujete ve svém účtu.
- Jedna běžící objednávka na odkaz. Dokud na trase běží objednávka pro určitý odkaz, druhá pro stejný odkaz se odmítne, stejně jako to dělají sami poskytovatelé.
- Dál se může posunout i zrušení před doručením, pokud jste to zapnuli. Co částečná objednávka nedoručila, se posune dál, jen pokud jste o to požádali.
Chyby
| Chyba | Co znamená |
|---|---|
Invalid API key | Klíč je chybný, nahrazený nebo zneplatněný. |
This key is limited to certain addresses… | Požadavek přišel z adresy, která není na seznamu klíče. |
Incorrect request | Neznámý action. |
Incorrect service ID | Žádná vaše trasa nemá toto ID. Smazaná trasa si své číslo ponechá a nikdy se nepřidělí jiné. |
Incorrect order ID | Žádná vaše objednávka nemá toto číslo. |
Link is required, Quantity is required | Některé pole akce add chybí nebo není číslo. |
A route takes a link and a quantity only | Požadavek obsahoval postupné dodávání, komentáře nebo jiné pole navíc. |
This route is switched off | Zapněte to ve svém účtu. |
This route already has an order for this link… | Počkejte, až ta běžící skončí. |
No step of this route can take this order right now. … | Všechny kroky byly přeskočeny dřív, než se cokoli odeslalo. Text uvádí každý panel a jeho důvod. |
No step of this route accepted the order. … | Každý oslovený krok odmítl. Nic nebylo účtováno. |
Too many requests… | Překročen limit uvedený níže. Počkejte minutu. |
Pří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 add odpovídáme vždy do 30 sekund. Trasa může oslovit několik poskytovatelů po sobě; každý dostane zbytek tohoto času a poskytovatel, na kterého by nebylo možné počkat, se vůbec neosloví. Pokud poslední oslovený neodpoví do vypršení času, dostanete číslo objednávky se stavem Pending a trasa se zastaví, dokud nebude odpověď známa. Většina objednávek dostane odpověď za jednu až dvě sekundy.
Limity a bezpečnost
- 300 požadavků za minutu na klíč, z toho 120 na objednávky. Až 100 ID objednávek v jednom
statusvolání. - Klíč se zobrazí jednou a uchovává se jako otisk. Znovu ho nepřečteme my ani vy. Jeho nahrazení starý klíč okamžitě vypne.
- Povolené adresy. Uveďte ve svém účtu adresu serveru svého panelu a klíč nebude fungovat odnikud jinud.
- ID trasy není tajemství a nemusí být. Funguje jen spolu s klíčem účtu, kterému trasa patří.
- Vaše limity stále platí. Denní limit každého panelu, vlastní denní limit trasy a její největší objednávka platí pro objednávky přijaté přes API úplně stejně jako pro ty, které zadáte ručně.
- Peníze nikdy neprocházejí přes smm.guide. Každá objednávka se platí z vašeho zůstatku na panelu, který ji převezme. Vrácení peněz a spory zůstávají mezi vámi a tímto panelem.
Chcete spíš číst katalog?
Panely, Trust Score a aktuální ceny mají vlastní API a MCP server pro asistenty.