Orders API

smm.guide-y paneliňize üpjün ediji hökmünde goşuň. Hasabyňyzda gurýan her marşrutyňyz öz ID-si bolan hyzmatdyr: paneliňiz sargydy şol ID-ä iberýär, marşrut bolsa ony üpjün edijileriňiziň ony alyp biljek birinjisine geçirýär.

Üç ädim

Format SMM panelleriniň öz aralarynda eýýäm ulanýan formatydyr, şonuň üçin hiç zat programmirlemeli däl.

1Marşrut dörediňHasap, Orders desk, Marşrutlar. Onuň näme ýerine ýetirýändigini saýlaň we birikdiren panelleriňizden şol görnüşdäki bäş hyzmata çenli goşuň.
2Açar dörediňOrders desk, Orders API. Açar bir gezek görkezilýär. Ony paneliňiziň serweriniň salgysy bilen çäklendirip bilersiňiz.
3Paneliňizde üpjün ediji goşuňAPI URL https://smm.guide/api/v2 we açary goýuň. Hyzmatlary import ediň: marşrutlaryňyz ID-leri, bahalary we çäkleri bilen gelýär.

Soragyň formaty

HTTP usulyPOST
API URLhttps://smm.guide/api/v2
Bodyapplication/x-www-form-urlencoded, ýa-da JSON, şu bilen: Content-Type: application/json. A multipart/form-data body hem okalýar: PHP-de cURL-a massiw berlende şeýle iberilýär
JogapJSON, elmydama HTTP 200 bilen, okap bilmeýän body-myz ýa-da gaty uly sorag üçin hem. Ýalňyşlyk şeýle görnüşde: {"error": "…"}
PulABŞ dollary. Bahalar 1 000 üçin

Hyzmatlaryň sanawy

Häzir sargyt alyp bilýän marşrutlaryňyz. Öçürilen ýa-da ähli ädimleri çykan marşrut sanawda görkezilmeýär.

ParametrDüşündiriş
keyAPI açaryňyz
actionservices

Jogap

[
  {
    "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 marşrutyň sargyt alyp biljek ädimleriniň iň gymmadydyr, häzirlikçe geçilýänler hem goşmak bilen (şu gün işlemeýän panel ertir dolanyp gelýär), şeýlelikde sargyt hiç haçan paneliňiziň import eden bahasyndan gymmat düşmeýär. min we max işleýän ädimleriň bilelikde kabul edýän iň giň çäkleridir; diňe käbirine laýyk gelýän mukdar şolaryň birine gidýär. refill we cancel şeýle ädimleriň hemmesi olary teklip edende true bolýar.

Öçürilen ýa-da işläp biljek hiç bir ädimi bolmadyk marşrut yzyna dolanýança bu sanawdan çykarylýar. Hyzmatlaryny awtomatik sinhronlaşdyrýan panel şol hyzmaty şol wagt üçin öz tarapynda öçürer, bu-da siziň isleýän zadyňyz: onuň sargytlary ret ediler.

Sargyt goşuň

ParametrDüşündiriş
keyAPI açaryňyz
actionadd
serviceMarşrutyň ID-si, sekiz san
linkSahypa, ýazga ýa-da profile salgylanma
quantityGerekli mukdar

Jogap

{
  "order": 23501
}

Hiç kim kabul etmedi

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

Sargydyň belgisi, ony haýsy üpjün ediji ýerine ýetirse-de, sargydyň bütin ömründe üýtgemeýär. Marşrut salgylanma we mukdar kabul edýär; tapgyrlaýyn ýerine ýetiriş, teswirler we beýleki goşmaça meýdançalar ret edilýär.

Sargydyň ýagdaýy

ParametrDüşündiriş
keyAPI açaryňyz
actionstatus
orderSargyt ID

Jogap

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
ParametrDüşündiriş
keyAPI açaryňyz
actionstatus
ordersSargyt ID-leri, otur bilen bölünen, 100 çenli

Jogap

{
  "23501": {
    "charge": "0.0045",
    "start_count": "3572",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "99": { "error": "Incorrect order ID" }
}
ÝagdaýManysy
PendingÜpjün ediji tarapyndan kabul edildi we entek başlanmady. Şeýle hem üpjün edijiniň anyk jogap bermedik sargydy: siz ony hasabyňyzda barlaýançaňyz marşrut şol ýerde togtaýar.
In progress, ProcessingÜpjün ediji ony ýerine ýetirýär ýa-da sargyt indiki ädime barýar.
CompletedDoly ýerine ýetirildi.
PartialBölekleýin ýerine ýetirildi; remains ýerine ýetirilmedik bölegi görkezýär. Ol her ädimiň ýerine ýetiren zadyny hasaplaýar: bir ädim bölegini ýerine ýetirip, galany indikisinde ýatyrylanda sargyt «Ýatyryldy» däl-de, «Bölekleýin» bolýar. Tutumyň galanyny gaýtarmak barada üpjün ediji karar berýär.
CanceledHiç zat ýerine ýetirilmedi we başga hiç bir ädim sargydy almady. charge tutulyp galan zat bar bolsa, şony görkezýär.

charge üpjün edijileriň bu sargyt üçin tutan mukdarydyr, sargyt berlen günüň hümmeti boýunça dollarda. start_count ony başlan üpjün edijiden gelýär.

Balans

smm.guide siziň pulyňyzy saklamaýar. Bu san marşrutlaryňyzyň aňyrsyndaky panellerdäki balanslaryňyzyň dollardaky jemidir.

ParametrDüşündiriş
keyAPI açaryňyz
actionbalance

Jogap

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

Ýatyryň

Sargydy häzir saklaýan üpjün edijä, onuň hyzmaty ýatyrmagy teklip edýän bolsa, geçirilýär. Siziň ýatyran sargydyňyz hiç haçan indiki ädime iberilmeýär.

ParametrDüşündiriş
keyAPI açaryňyz
actioncancel
ordersSargyt ID-leri, otur bilen bölünen, 100 çenli

Jogap

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

Gaýtadan doldurma

Sargydy ýerine ýetiren üpjün edijä geçirilýär. Gaýtadan doldurma sargydyň öz belgisini göterýär.

ParametrDüşündiriş
keyAPI açaryňyz
actionrefill
orderSargyt ID. Ýa-da orders: birnäçesi, otur bilen bölünen

Jogap, bir sargyt

{ "refill": "23501" }

Jogap, birnäçesi

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
ParametrDüşündiriş
keyAPI açaryňyz
actionrefill_status
refillGaýtadan doldurma ID. Ýa-da refills: birnäçesi, otur bilen bölünen

Jogap

{ "status": "Completed" }

Marşrut sargyt bilen näme edýär

  • Ädimler siziň tertibiňizde ýa-da ilki iň arzan işleýäni synanyşylýar. Haýsysydygyny marşrutda saýlaýarsyňyz.
  • Ädim geçilýär, haçan-da onuň paneli jogap bermese, balansy ýa-da gündelik çägi sargydy ýapmasa, mukdar onuň kabul edýän çäginden daşarda bolsa, bahasy siziň bellän çägiňizden ýokary bolsa ýa-da onuň bahasynda sargyt marşrutyň öz gündelik çäginden geçse. Ol özi yzyna gaýdyp gelýär.
  • Ädim çykýar, haçan-da onuň hyzmaty baha sanawyndan aýrylsa ýa-da panel şol bir ID bilen başga bir zat satyp başlasa. Beýleki ädimler işlemegini dowam edýär we size habar berilýär.
  • Ret etmek sargydy öňe geçirýär. Panel jogap berip ret edende hiç zat tutulmadyk bolýar, şonuň üçin indiki ädim synanyşylýar.
  • Anyk jogabyň ýoklugy ony togtadýar. Wagtyň gutarmagy ýa-da bozuk jogap sargydyň bardygyny ýa-da ýokdugyny aýtmaýar. Ony indikä ibermek iki gezek ýerine ýetirip, iki gezek tutup biler, şonuň üçin marşrut togtaýar we siz şol sargydy hasabyňyzda barlaýarsyňyz.
  • Bir salgylanma üçin bir işleýän sargyt. Marşrutda bir salgylanma üçin sargyt işläp durka, şol salgylanma üçin ikinji sargyt ret edilýär, üpjün edijileriň özleri hem şeýle edýär.
  • Ýerine ýetirilmezden öňki ýatyrma hem öňe geçip biler, eger siz muny açan bolsaňyz. Bölekleýin sargydyň ýerine ýetirmän galdyran bölegi diňe siz muny soran bolsaňyz öňe geçýär.

Ýalňyşlyklar

ÝalňyşlykManysy
Invalid API keyAçar nädogry, çalşyryldy ýa-da ýatyryldy.
This key is limited to certain addresses…Sorag açaryň sanawynda ýok salgydan geldi.
Incorrect requestNäbelli action.
Incorrect service IDBu ID bilen marşrutyňyz ýok. Pozan marşrutyňyz belgisini saklaýar we ol hiç haçan başga birine berilmeýär.
Incorrect order IDBu belgi bilen sargydyňyz ýok.
Link is required, Quantity is requiredŞu meýdançalaryň biri add ýok ýa-da san däl.
A route takes a link and a quantity onlySoragda tapgyrlaýyn ýerine ýetiriş, teswirler ýa-da başga goşmaça meýdança bardy.
This route is switched offOny hasabyňyzda açyň.
This route already has an order for this link…Işleýän sargyt gutarýança garaşyň.
No step of this route can take this order right now. …Hiç zat iberilmezden öň ähli ädimler geçildi. Tekstde her panel we onuň sebäbi görkezilýär.
No step of this route accepted the order. …Soralan ähli ädimler ret etdi. Hiç zat tutulmady.
Too many requests…Aşakdaky çäkden geçildi. Bir minut garaşyň.

Mysallar

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

Her add soragyna elmydama 30 sekundyň içinde jogap berilýär. Marşrut birnäçe üpjün edijä yzly-yzyna ýüz tutup biler; her biri şol wagtyň galan bölegini alýar, garaşyp bolmajak üpjün edijä asla ýüz tutulmaýar. Wagt gutaranda soňky soralan üpjün ediji jogap bermedik bolsa, Pending ýagdaýly sargyt belgisini alýarsyňyz we jogap belli bolýança marşrut şol ýerde togtaýar. Sargytlaryň köpüsine bir-iki sekundda jogap berilýär.

Çäkler we howpsuzlyk

  • Bir açar üçin minutda 300 sorag, olaryň 120 sanysy sargyt. Bir gezekde 100 sargyt ID-sine çenli status sorag.
  • Açar bir gezek görkezilýär we barmak yzy hökmünde saklanýar. Ony ne siz, ne-de biz gaýtadan okap bilmeýäris. Ony çalşanyňyzda köne açar derrew öçýär.
  • Rugsat berlen salgylar. Hasabyňyzda paneliňiziň serweriniň salgysyny görkeziň, şonda açar başga hiç ýerden işlemeýär.
  • Marşrut ID-si gizlin däl we gizlin bolmagy hem gerek däl. Ol diňe marşrutyň eýesi bolan hasabyň açary bilen bilelikde işleýär.
  • Çäkleriňiz güýjünde galýar. Her paneliň gündelik çägi, marşrutyň öz gündelik çägi we onuň iň uly sargydy API arkaly gelýän sargytlara hem el bilen berýän sargytlaryňyz ýaly ulanylýar.
  • Pul hiç haçan smm.guide arkaly geçmeýär. Her sargyt ony kabul eden paneldäki balansyňyzdan tölenýär. Gaýtarmalar we jedeller siz bilen şol paneliň arasynda galýar.

Munuň ýerine katalogy okamakçymy?

Panelleriň, Trust Score-laryň we janly bahalaryň öz API-si we kömekçiler üçin MCP serweri bar.