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

1Vytvorte trasuÚčet, Orders desk, Trasy. Vyberte, čo trasa dodáva, a pridajte až päť služieb tohto druhu z panelov, ktoré ste pripojili.
2Vytvorte kľúčOrders desk, Orders API. Kľúč sa zobrazí raz. Môžete ho obmedziť na adresu servera svojho panelu.
3Pridajte poskytovateľa vo svojom paneliAPI URL 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ódaPOST
API URLhttps://smm.guide/api/v2
Teloapplication/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": "…"}
PeniazeAmerické 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.

ParameterPopis
keyVáš API kľúč
actionservices

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

ParameterPopis
keyVáš API kľúč
actionadd
serviceID trasy, osem číslic
linkOdkaz na stránku, príspevok alebo profil
quantityPož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

ParameterPopis
keyVáš API kľúč
actionstatus
orderID objednávky

Odpoveď

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
ParameterPopis
keyVáš API kľúč
actionstatus
ordersID 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" }
}
StavVýznam
PendingPrijatá 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, ProcessingPoskytovateľ ju dodáva alebo je objednávka na ceste k ďalšiemu kroku.
CompletedDodaná celá.
PartialDodaná č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ľ.
CanceledNič 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.

ParameterPopis
keyVáš API kľúč
actionbalance

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.

ParameterPopis
keyVáš API kľúč
actioncancel
ordersID 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.

ParameterPopis
keyVáš API kľúč
actionrefill
orderID objednávky. Alebo orders: viacero, oddelených čiarkou

Odpoveď, jedna objednávka

{ "refill": "23501" }

Odpoveď, viacero

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
ParameterPopis
keyVáš API kľúč
actionrefill_status
refillID 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 keyKľúč 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 requestNezná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 requiredPole add chýba alebo nie je číslo.
A route takes a link and a quantity onlyPožiadavka obsahovala postupné dodávanie, komentáre alebo iné ďalšie pole.
This route is switched offZapnite 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 status volanie.
  • 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.