Orders API

smm.guide-ı panelinizə provayder kimi əlavə edin. Hesabınızda qurduğunuz hər marşrut öz ID-si olan xidmətdir: paneliniz sifarişi həmin ID-yə göndərir, marşrut isə onu provayderlərinizdən sifarişi qəbul edə bilən birincisinə ötürür.

Üç addım

Format SMM panellərinin öz aralarında artıq istifadə etdiyi formatdır, ona görə heç nə proqramlaşdırmaq lazım deyil.

1Marşrut qurunHesab, Orders desk, Marşrutlar. Marşrutun nə yerinə yetirəcəyini seçin və qoşduğunuz panellərdən həmin növdən beşə qədər xidmət əlavə edin.
2Açar yaradınOrders desk, Orders API. Açar bir dəfə göstərilir. Onu panelinizin serverinin ünvanı ilə məhdudlaşdıra bilərsiniz.
3Panelinizdə provayder əlavə edinAPI URL https://smm.guide/api/v2 və açarı daxil edin. Xidmətləri idxal edin: marşrutlarınız ID-ləri, qiymətləri və limitləri ilə gələcək.

Sorğu formatı

HTTP metoduPOST
API URLhttps://smm.guide/api/v2
Gövdəapplication/x-www-form-urlencoded, və ya JSON ilə Content-Type: application/json. A multipart/form-data gövdə də oxunur — cURL-ə massiv veriləndə PHP məhz bunu göndərir
CavabJSON, həmişə HTTP 200 ilə, hətta oxuya bilmədiyimiz gövdə və ya çox böyük sorğu üçün də. Xəta belə görünür: {"error": "…"}
PulABŞ dolları. Qiymətlər 1.000 ədəd üçündür

Xidmət siyahısı

Hazırda sifariş qəbul edə bilən marşrutlarınız. Söndürülmüş və ya bütün addımları sıradan çıxmış marşrut siyahıda göstərilmir.

ParametrTəsvir
keyAPI açarınız
actionservices

Cavab

[
  {
    "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şrutun sifariş qəbul edə biləcək ən baha addımının qiymətidir, hazırda ötürülən addımlar da daxil olmaqla (bu gün işləməyən panel sabah qayıdır); beləliklə sifariş heç vaxt panelinizin idxal etdiyi qiymətdən baha olmur. min və max — işlək addımların birlikdə əhatə etdiyi ən geniş aralıqdır; yalnız bəzilərinə uyğun gələn miqdar onlardan birinə gedir. refill və cancel — belə addımların hamısı bunları təklif etdikdə true olur.

Söndürülmüş və ya işləyə bilən addımı olmayan marşrut qayıdana qədər bu siyahıdan çıxarılır. Xidmətlərini avtomatik sinxronlaşdıran panel həmin müddətə bu xidməti öz tərəfində söndürəcək — elə istədiyiniz də budur: onun sifarişləri rədd ediləcəkdi.

Sifariş əlavə edin

ParametrTəsvir
keyAPI açarınız
actionadd
serviceMarşrutun ID-si, səkkiz rəqəm
linkSəhifəyə, paylaşıma və ya profilə keçid
quantityLazım olan miqdar

Cavab

{
  "order": 23501
}

Heç kim qəbul etmədi

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

Sifariş nömrəsi, sonda hansı provayder yerinə yetirsə də, sifarişin bütün ömrü boyu eyni qalır. Marşrut keçid və miqdar qəbul edir; drip-feed, şərhlər və digər əlavə sahələr rədd edilir.

Sifariş statusu

ParametrTəsvir
keyAPI açarınız
actionstatus
orderSifariş ID-si

Cavab

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
ParametrTəsvir
keyAPI açarınız
actionstatus
ordersVergüllə ayrılmış sifariş ID-ləri, ən çox 100

Cavab

{
  "23501": {
    "charge": "0.0045",
    "start_count": "3572",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "99": { "error": "Incorrect order ID" }
}
StatusMənası
PendingProvayder qəbul edib, hələ başlamayıb. Həmçinin provayderin aydın cavab vermədiyi sifariş: siz onu hesabınızda yoxlayana qədər marşrut orada dayanır.
In progress, ProcessingProvayder onu yerinə yetirir və ya sifariş növbəti addıma keçir.
CompletedTam yerinə yetirilib.
PartialQismən yerinə yetirilib; remains — yerinə yetirilməyən hissədir. Bütün addımların yerinə yetirdiyi nəzərə alınır: bir addım bir hissəni yerinə yetirib, qalanı növbəti addımda ləğv edilibsə, sifariş Canceled deyil, Partial olur. Tutulmuş məbləğin qalanını qaytarmağa provayder qərar verir.
CanceledHeç nə yerinə yetirilməyib və sifarişi başqa addım qəbul etməyib. charge — əgər varsa, tutulmuş qalan məbləği göstərir.

charge — provayderlərin bu sifariş üçün tutduğu məbləğdir, sifarişin verildiyi günün məzənnəsi ilə dollarla. start_count — onu başladan provayderdən gəlir.

Balans

smm.guide sizin pulunuzu saxlamır. Bu rəqəm marşrutlarınızın arxasındakı panellərdəki balanslarınızın dollarla cəmidir.

ParametrTəsvir
keyAPI açarınız
actionbalance

Cavab

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

Ləğv edin

Hazırda sifarişi saxlayan provayderə ötürülür, əgər onun xidməti ləğvi dəstəkləyirsə. Ləğv etdiyiniz sifariş heç vaxt növbəti addıma göndərilmir.

ParametrTəsvir
keyAPI açarınız
actioncancel
ordersVergüllə ayrılmış sifariş ID-ləri, ən çox 100

Cavab

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

Bərpa

Sifarişi yerinə yetirən provayderə ötürülür. Bərpa sorğusu sifarişin öz nömrəsini daşıyır.

ParametrTəsvir
keyAPI açarınız
actionrefill
orderSifariş ID-si. Və ya orders: vergüllə ayrılmış bir neçə ID

Cavab, bir sifariş

{ "refill": "23501" }

Cavab, bir neçə sifariş

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
ParametrTəsvir
keyAPI açarınız
actionrefill_status
refillBərpa ID-si. Və ya refills: vergüllə ayrılmış bir neçə ID

Cavab

{ "status": "Completed" }

Marşrut sifarişlə nə edir

  • Addımlar sizin ardıcıllığınızla və ya əvvəlcə ən ucuz işlək addım olmaqla sınanır. Hansını seçəcəyinizi marşrutda müəyyən edirsiniz.
  • Addım ötürülür, əgər onun paneli cavab vermirsə, balansı və ya gündəlik limiti sifarişi ödəmirsə, miqdar onun qəbul etdiyi aralıqdan kənardırsa, qiyməti təyin etdiyiniz limitdən yuxarıdırsa və ya onun qiyməti ilə sifariş marşrutun öz gündəlik limitini aşacaqsa. O, özü geri qayıdır.
  • Addım sıradan çıxır, əgər onun xidməti qiymət siyahısından çıxırsa və ya panel eyni ID altında başqa şey satmağa başlayırsa. Digər addımlar işləməyə davam edir və sizə bildirilir.
  • İmtina sifarişi irəli ötürür. Panel cavab verib imtina edəndə heç nə tutulmayıb, ona görə növbəti addım sınanır.
  • Aydın olmayan cavab onu dayandırır. Vaxt aşımı və ya pozulmuş cavab sifarişin mövcud olub-olmadığını bildirmir. Onu ötürmək ikiqat icraya və ikiqat ödənişə səbəb ola bilər, ona görə marşrut dayanır və siz həmin sifarişi hesabınızda yoxlayırsınız.
  • Hər keçid üçün bir aktiv sifariş. Keçid üçün sifariş marşrutda icra olunarkən eyni keçid üçün ikinci sifariş rədd edilir — provayderlərin özləri də belə edir.
  • Yerinə yetirilmədən əvvəl ləğv də irəli ötürülə bilər, əgər bunu aktivləşdirmisinizsə. Qismən sifarişin yerinə yetirilməmiş hissəsi yalnız bunu istədikdə irəli ötürülür.

Xətalar

XətaNə deməkdir
Invalid API keyAçar səhvdir, əvəz olunub və ya ləğv edilib.
This key is limited to certain addresses…Sorğu açarın siyahısında olmayan ünvandan gəlib.
Incorrect requestNaməlum action.
Incorrect service IDBu ID ilə marşrutunuz yoxdur. Sildiyiniz marşrut öz nömrəsini saxlayır və bu nömrə heç vaxt başqasına verilmir.
Incorrect order IDBu nömrə ilə sifarişiniz yoxdur.
Link is required, Quantity is requiredBu sahələrdən biri — add — yoxdur və ya rəqəm deyil.
A route takes a link and a quantity onlySorğuda drip-feed, şərhlər və ya başqa əlavə sahə var idi.
This route is switched offOnu hesabınızda aktivləşdirin.
This route already has an order for this link…İcra olunan sifariş bitənə qədər gözləyin.
No step of this route can take this order right now. …Heç nə göndərilmədən bütün addımlar ötürüldü. Mətndə hər panel və onun səbəbi göstərilir.
No step of this route accepted the order. …Soruşulan hər addım imtina etdi. Heç nə tutulmadı.
Too many requests…Aşağıdakı limit aşılıb. Bir dəqiqə gözləyin.

Nümunələr

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

Hər add sorğusuna həmişə 30 saniyə ərzində cavab verilir. Marşrut bir neçə provayderdən ardıcıl soruşa bilər; hər biri həmin vaxtın qalanını alır, gözlənilə bilməyəcək provayderdən isə ümumiyyətlə soruşulmur. Vaxt bitəndə son soruşulan provayder cavab verməyibsə, Pending statuslu sifariş nömrəsi alırsınız və cavab məlum olana qədər marşrut orada dayanır. Sifarişlərin çoxuna bir-iki saniyəyə cavab verilir.

Limitlər və təhlükəsizlik

  • Hər açar üçün dəqiqədə 300 sorğu, onlardan 120 sifariş. Bir sorğuda ən çox 100 sifariş ID-si status sorğu.
  • Açar bir dəfə göstərilir və iz kimi saxlanılır. Onu nə siz, nə də biz yenidən oxuya bilərik. Əvəz etdikdə köhnəsi dərhal söndürülür.
  • İcazə verilən ünvanlar. Hesabınızda panelinizin server ünvanını qeyd edin — açar başqa heç yerdən işləməyəcək.
  • Marşrut ID-si sirr deyil və olmalı da deyil. O, yalnız marşrutun sahibi olan hesabın açarı ilə birlikdə işləyir.
  • Limitləriniz qüvvədə qalır. Hər panelin gündəlik limiti, marşrutun öz gündəlik limiti və ən böyük sifariş həddi API vasitəsilə gələn sifarişlərə əl ilə verdiklərinizlə eyni şəkildə tətbiq olunur.
  • Pul heç vaxt smm.guide-dan keçmir. Hər sifariş onu qəbul edən paneldəki balansınızdan ödənilir. Geri qaytarma və mübahisələr sizinlə həmin panel arasında qalır.

Kataloqu oxumaq istəyirsiniz?

Panellər, Trust Score-lar və canlı qiymətlər üçün ayrıca API və assistentlər üçün MCP serveri var.