Acasă / Dezvoltatori / Orders API

Orders API

Adăugați smm.guide în panoul dvs. ca furnizor. Fiecare rută creată în contul dvs. este un serviciu cu propriul ID: panoul trimite o comandă la acel ID, iar ruta o transmite primului dintre furnizorii dvs. care o poate prelua.

Trei pași

Formatul este cel pe care panourile SMM îl folosesc deja între ele, deci nu este nimic de programat.

1Creați o rutăCont, Orders desk, Rute. Alegeți ce livrează și adăugați până la cinci servicii de acest tip de pe panourile pe care le-ați conectat.
2Creați cheiaOrders desk, Orders API. Cheia este afișată o singură dată. O puteți limita la adresa serverului panoului dvs.
3Adăugați un furnizor în panoul dvs.URL API https://smm.guide/api/v2 și cheia. Importați serviciile: rutele dvs. sosesc cu ID-urile, prețurile și limitele lor.

Formatul solicitării

Metoda HTTPPOST
URL APIhttps://smm.guide/api/v2
Corpapplication/x-www-form-urlencoded, sau JSON cu Content-Type: application/json. A multipart/form-data corpul este citit și el, adică ce trimite PHP când cURL primește un array
RăspunsJSON, întotdeauna cu HTTP 200, inclusiv pentru un corp pe care nu îl putem citi sau o solicitare prea mare. O eroare este {"error": "…"}
BaniDolari americani. Prețurile sunt per 1.000

Lista de servicii

Rutele dvs. care pot prelua o comandă chiar acum. O rută dezactivată sau ai cărei pași sunt toți excluși nu este listată.

ParametruDescriere
keyCheia dvs. API
actionservices

Răspuns

[
  {
    "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 este cel mai scump dintre pașii rutei care pot prelua o comandă, inclusiv cei omiși momentan (un panou căzut astăzi revine mâine), astfel încât o comandă nu costă niciodată mai mult decât prețul importat de panoul dvs. min și max sunt cele mai largi pe care le acoperă împreună pașii funcționali; o cantitate care se încadrează doar în limitele unora dintre ei merge la unul dintre aceștia. refill și cancel sunt true când fiecare astfel de pas le oferă.

O rută dezactivată sau fără niciun pas funcțional este exclusă din această listă până revine. Un panou care își sincronizează automat serviciile va dezactiva acel serviciu la el pentru aceeași perioadă, ceea ce și doriți: comenzile lui ar fi refuzate.

Adăugați o comandă

ParametruDescriere
keyCheia dvs. API
actionadd
serviceID-ul rutei, opt cifre
linkLinkul către pagină, postare sau profil
quantityCantitatea necesară

Răspuns

{
  "order": 23501
}

Nimeni nu a acceptat-o

{
  "error": "No step of this route accepted the order. …"
}

Numărul comenzii rămâne același pe toată durata comenzii, indiferent de furnizorul care o livrează în final. O rută acceptă un link și o cantitate; livrarea treptată, comentariile și alte câmpuri suplimentare sunt refuzate.

Starea comenzii

ParametruDescriere
keyCheia dvs. API
actionstatus
orderID comandă

Răspuns

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
ParametruDescriere
keyCheia dvs. API
actionstatus
ordersID-uri de comenzi separate prin virgulă, până la 100

Răspuns

{
  "23501": {
    "charge": "0.0045",
    "start_count": "3572",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "99": { "error": "Incorrect order ID" }
}
StareSemnificație
PendingAcceptată de un furnizor și încă nepornită. De asemenea, o comandă la care un furnizor nu a dat un răspuns clar: ruta se oprește acolo până când o verificați în contul dvs.
In progress, ProcessingUn furnizor o livrează sau comanda este în drum spre pasul următor.
CompletedLivrată integral.
PartialLivrată parțial; remains este ce nu s-a livrat. Se ia în calcul ce a livrat fiecare pas: când un pas a livrat o parte, iar restul a fost anulat la următorul, comanda este Partial, nu Canceled. Furnizorul decide asupra returnării restului sumei debitate.
CanceledNu s-a livrat nimic și niciun alt pas nu a preluat comanda. charge arată ce a rămas debitat, dacă a rămas ceva.

charge este suma debitată de furnizori pentru această comandă, în dolari, la cursul din ziua plasării. start_count provine de la furnizorul care a pornit-o.

Sold

smm.guide nu deține niciun ban al dvs. Cifra este suma soldurilor dvs. de pe panourile din spatele rutelor, în dolari.

ParametruDescriere
keyCheia dvs. API
actionbalance

Răspuns

{
  "balance": "126.1375",
  "currency": "USD"
}

Anulați

Transmisă furnizorului care deține comanda acum, dacă serviciul său oferă anulare. O comandă pe care o anulați nu este trimisă niciodată la pasul următor.

ParametruDescriere
keyCheia dvs. API
actioncancel
ordersID-uri de comenzi separate prin virgulă, până la 100

Răspuns

[
  { "order": 23501, "cancel": 1 },
  { "order": 23502, "cancel": { "error": "The order is already finished" } }
]

Refill

Transmis furnizorului care a livrat comanda. Refill-ul poartă numărul propriu al comenzii.

ParametruDescriere
keyCheia dvs. API
actionrefill
orderID-ul comenzii. Sau orders: mai multe, separate prin virgulă

Răspuns, o comandă

{ "refill": "23501" }

Răspuns, mai multe

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
ParametruDescriere
keyCheia dvs. API
actionrefill_status
refillID-ul refill-ului. Sau refills: mai multe, separate prin virgulă

Răspuns

{ "status": "Completed" }

Ce face o rută cu o comandă

  • Pașii sunt încercați în ordinea dvs. sau începând cu cel mai ieftin pas funcțional. Alegeți varianta în setările rutei.
  • Un pas este omis când panoul său nu răspunde, soldul sau limita zilnică nu acoperă comanda, cantitatea este în afara limitelor acceptate, prețul depășește limita setată de dvs. sau, la prețul său, comanda ar depăși limita zilnică a rutei. Revine automat.
  • Un pas este exclus când serviciul său dispare din lista de prețuri sau panoul începe să vândă altceva sub același ID. Ceilalți pași continuă să funcționeze și sunteți anunțat.
  • Un refuz trimite comanda mai departe. Când un panou răspunde și refuză, nu s-a debitat nimic, așa că se încearcă pasul următor.
  • Lipsa unui răspuns clar o oprește. Un timeout sau un răspuns defect nu spune dacă comanda există. Trimiterea ei mai departe ar putea duce la livrare și debitare dublă, așa că ruta se oprește, iar dvs. verificați acea comandă în contul dvs.
  • O singură comandă activă per link. Cât timp o comandă pentru un link rulează pe o rută, a doua pentru același link este refuzată, cum fac și furnizorii.
  • O anulare înainte de livrare poate trece și ea mai departe, dacă ați activat această opțiune. Ce a rămas nelivrat dintr-o comandă parțială trece mai departe doar dacă ați cerut asta.

Erori

EroareCe înseamnă
Invalid API keyCheia este greșită, înlocuită sau revocată.
This key is limited to certain addresses…Solicitarea a venit de la o adresă care nu se află pe lista cheii.
Incorrect requestNecunoscut action.
Incorrect service IDNicio rută a dvs. nu are acest ID. O rută ștearsă își păstrează numărul, iar acesta nu este atribuit niciodată alteia.
Incorrect order IDNicio comandă a dvs. nu are acest număr.
Link is required, Quantity is requiredUn câmp din add lipsește sau nu este un număr.
A route takes a link and a quantity onlySolicitarea conținea livrare treptată, comentarii sau alt câmp suplimentar.
This route is switched offActivați-o în contul dvs.
This route already has an order for this link…Așteptați până se încheie cea activă.
No step of this route can take this order right now. …Fiecare pas a fost omis înainte de a se trimite ceva. Textul numește fiecare panou și motivul.
No step of this route accepted the order. …Fiecare pas solicitat a refuzat. Nu s-a debitat nimic.
Too many requests…Peste limita de mai jos. Așteptați un minut.

Exemple

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]);

O solicitare add primește întotdeauna răspuns în cel mult 30 de secunde. O rută poate întreba mai mulți furnizori, unul după altul; fiecare primește ce a rămas din acest timp, iar un furnizor care nu ar mai putea fi așteptat nu este întrebat deloc. Dacă ultimul întrebat nu a răspuns când timpul expiră, primiți un număr de comandă cu starea Pending, iar ruta se oprește acolo până când răspunsul este cunoscut. Majoritatea comenzilor primesc răspuns în una-două secunde.

Limite și securitate

  • 300 cereri pe minut per cheie, dintre care 120 comenzi. Până la 100 ID-uri de comenzi într-o singură status apel.
  • Cheia este afișată o singură dată și păstrată ca amprentă. Nici dvs., nici noi nu o mai putem citi. Înlocuirea ei o dezactivează imediat pe cea veche.
  • Adrese permise. Indicați în cont adresa serverului panoului dvs., iar cheia nu va funcționa de nicăieri altundeva.
  • Un ID de rută nu este secret și nici nu trebuie să fie. Funcționează doar împreună cu cheia contului care deține ruta.
  • Limitele dvs. rămân valabile. Limita zilnică a fiecărui panou, limita zilnică a rutei și comanda ei maximă se aplică comenzilor sosite prin API exact ca celor plasate manual.
  • Banii nu trec niciodată prin smm.guide. Fiecare comandă se plătește din soldul dvs. de pe panoul care o preia. Rambursările și disputele rămân între dvs. și acel panou.

Doriți de fapt să citiți catalogul?

Panourile, scorurile Trust Score și prețurile live au propriul API, plus un server MCP pentru asistenți.