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.

1Vytvořte trasuÚčet, Orders desk, Trasy. Vyberte, co trasa doručuje, a přidejte až pět služeb tohoto druhu z panelů, které jste připojili.
2Vytvořte klíčOrders desk, Orders API. Klíč se zobrazí jednou. Můžete ho omezit na adresu serveru vašeho panelu.
3Přidejte ve svém panelu poskytovateleURL API 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 HTTPPOST
URL APIhttps://smm.guide/api/v2
Těloapplication/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ízeAmerické 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í.

ParametrPopis
keyVáš klíč API
actionservices

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

ParametrPopis
keyVáš klíč API
actionadd
serviceID trasy, osm číslic
linkOdkaz na stránku, příspěvek nebo profil
quantityPož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

ParametrPopis
keyVáš klíč API
actionstatus
orderID objednávky

Odpověď

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
ParametrPopis
keyVáš klíč API
actionstatus
ordersID 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" }
}
StavVýznam
PendingPř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, ProcessingPoskytovatel ji doručuje, nebo je objednávka na cestě k dalšímu kroku.
CompletedDoručena celá.
PartialDoruč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.
CanceledNic 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.

ParametrPopis
keyVáš klíč API
actionbalance

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á.

ParametrPopis
keyVáš klíč API
actioncancel
ordersID 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.

ParametrPopis
keyVáš klíč API
actionrefill
orderID 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": "…" } }
]
ParametrPopis
keyVáš klíč API
actionrefill_status
refillID 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

ChybaCo znamená
Invalid API keyKlíč 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 requestNezná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 requiredNěkteré pole akce add chybí nebo není číslo.
A route takes a link and a quantity onlyPožadavek obsahoval postupné dodávání, komentáře nebo jiné pole navíc.
This route is switched offZapně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 status volá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.