Orders API

smm.guide saytini panelingizga provayder sifatida qoʻshing. Hisobingizda yaratgan har bir marshrut — oʻz ID raqamiga ega xizmat: panelingiz shu ID raqamiga buyurtma yuboradi, marshrut esa uni provayderlaringizdan buyurtmani qabul qila oladigan birinchisiga uzatadi.

Uch qadam

Bu SMM panellar oʻzaro allaqachon ishlatadigan format, shuning uchun hech narsa dasturlash shart emas.

1Marshrut yaratingHisob, Orders desk, Marshrutlar. U nimani bajarishini tanlang va ulangan panellaringizdan shu turdagi beshtagacha xizmatni qoʻshing.
2Kalit yaratingOrders desk, Orders API. Kalit bir marta koʻrsatiladi. Uni panelingiz serveri manzili bilan cheklashingiz mumkin.
3Panelingizda provayder qoʻshingAPI URL https://smm.guide/api/v2 va kalitni kiriting. Xizmatlarni import qiling: marshrutlaringiz ID raqamlari, narxlari va limitlari bilan keladi.

Soʻrov formati

HTTP metodiPOST
API URLhttps://smm.guide/api/v2
Tanaapplication/x-www-form-urlencoded, yoki JSON va Content-Type: application/json. A multipart/form-data tanasi ham oʻqiladi — cURL massiv olganda PHP aynan shuni yuboradi
JavobJSON, doim HTTP 200 bilan, hatto biz oʻqiy olmaydigan tana yoki juda katta soʻrov uchun ham. Xato quyidagicha: {"error": "…"}
PulAQSh dollari. Narxlar 1 000 tasi uchun

Xizmatlar roʻyxati

Hozir buyurtma qabul qila oladigan marshrutlaringiz. Oʻchirilgan yoki barcha qadamlari ishdan chiqqan marshrut roʻyxatga kirmaydi.

ParametrTavsif
keyAPI kalitingiz
actionservices

Javob

[
  {
    "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 — marshrutning buyurtma qabul qilishi mumkin boʻlgan qadamlaridan eng qimmati, hozircha oʻtkazib yuborilganlari ham hisobga olinadi (bugun ishlamayotgan panel ertaga qaytadi), shuning uchun buyurtma hech qachon panelingiz import qilgan narxdan qimmatga tushmaydi. min va max — ishlayotgan qadamlar birgalikda qamrab oladigan eng keng chegaralar; faqat ularning ayrimlariga sigʻadigan miqdor shulardan biriga yuboriladi. refill va cancel — faqat shunday qadamlarning barchasi ularni taklif qilganda true boʻladi.

Oʻchirilgan yoki ishlay oladigan birorta qadami boʻlmagan marshrut qaytib kelguncha bu roʻyxatdan chiqarib qoʻyiladi. Xizmatlarini avtomatik sinxronlaydigan panel oʻz tomonida bu xizmatni xuddi shu muddatga oʻchiradi — aynan shu sizga kerak: aks holda uning buyurtmalari rad etilardi.

Buyurtma qoʻshish

ParametrTavsif
keyAPI kalitingiz
actionadd
serviceMarshrut ID raqami, sakkiz xonali
linkSahifa, post yoki profilga havola
quantityKerakli miqdor

Javob

{
  "order": 23501
}

Hech kim qabul qilmadi

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

Buyurtma raqami buyurtmaning butun umri davomida, uni qaysi provayder bajarishidan qatʼi nazar, oʻzgarmaydi. Marshrut havola va miqdorni qabul qiladi; drip-feed, izohlar va boshqa qoʻshimcha maydonlar rad etiladi.

Buyurtma holati

ParametrTavsif
keyAPI kalitingiz
actionstatus
orderBuyurtma ID

Javob

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
ParametrTavsif
keyAPI kalitingiz
actionstatus
ordersVergul bilan ajratilgan buyurtma ID raqamlari, 100 tagacha

Javob

{
  "23501": {
    "charge": "0.0045",
    "start_count": "3572",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "99": { "error": "Incorrect order ID" }
}
HolatMaʼnosi
PendingProvayder qabul qilgan, lekin hali boshlanmagan. Shuningdek, provayder aniq javob bermagan buyurtma ham: siz uni hisobingizda tekshirmaguningizcha marshrut shu yerda toʻxtaydi.
In progress, ProcessingProvayder uni bajarmoqda yoki buyurtma keyingi qadamga yoʻl olmoqda.
CompletedToʻliq bajarildi.
PartialQisman bajarildi; remains — bajarilmagan qism. U barcha qadamlar bajarganini hisobga oladi: bir qadam bir qismini bajarib, qolgani keyingisida bekor qilingan boʻlsa, buyurtma Canceled emas, Partial boʻladi. Yechilgan summaning qolganini qaytarish haqida provayder qaror qiladi.
CanceledHech narsa bajarilmadi va boshqa hech bir qadam buyurtmani olmadi. charge — yechilgan holda qolgan summani (agar boʻlsa) koʻrsatadi.

charge — provayderlar bu buyurtma uchun yechgan summa, buyurtma berilgan kundagi kurs boʻyicha dollarda. start_count — uni boshlagan provayderdan olinadi.

Balans

smm.guide sizning pulingizni saqlamaydi. Bu raqam — marshrutlaringiz ortidagi panellardagi balanslaringiz yigʻindisi, dollarda.

ParametrTavsif
keyAPI kalitingiz
actionbalance

Javob

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

Bekor qilish

Agar xizmati bekor qilishni taklif qilsa, buyurtmani hozir ushlab turgan provayderga uzatiladi. Siz bekor qilgan buyurtma hech qachon keyingi qadamga yuborilmaydi.

ParametrTavsif
keyAPI kalitingiz
actioncancel
ordersVergul bilan ajratilgan buyurtma ID raqamlari, 100 tagacha

Javob

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

Qayta toʻldirish

Buyurtmani bajargan provayderga uzatiladi. Qayta toʻldirish buyurtmaning oʻz raqamini oladi.

ParametrTavsif
keyAPI kalitingiz
actionrefill
orderBuyurtma ID. Yoki orders: bir nechtasi, vergul bilan ajratilgan

Javob, bitta buyurtma

{ "refill": "23501" }

Javob, bir nechta

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
ParametrTavsif
keyAPI kalitingiz
actionrefill_status
refillQayta toʻldirish ID. Yoki refills: bir nechtasi, vergul bilan ajratilgan

Javob

{ "status": "Completed" }

Marshrut buyurtma bilan nima qiladi

  • Qadamlar siz belgilagan tartibda yoki eng arzon ishlaydigani birinchi sinab koʻriladi. Qaysi biri — marshrutda tanlaysiz.
  • Qadam oʻtkazib yuboriladi, agar uning paneli javob bermasa, balansi yoki kunlik limiti buyurtmani qoplamasa, miqdor u qabul qiladigan chegaradan tashqarida boʻlsa, narxi siz belgilagan limitdan yuqori boʻlsa yoki uning narxida buyurtma marshrutning oʻz kunlik limitidan oshib ketsa. U oʻzi qaytadi.
  • Qadam chiqib ketadi, agar uning xizmati narxlar roʻyxatidan chiqsa yoki panel xuddi shu ID ostida boshqa narsa sota boshlasa. Boshqa qadamlar ishlashda davom etadi va sizga xabar beriladi.
  • Rad etish buyurtmani keyingisiga oʻtkazadi. Panel javob berib rad etsa, hech narsa yechilmagan boʻladi, shuning uchun keyingi qadam sinab koʻriladi.
  • Aniq javob boʻlmasa, marshrut toʻxtaydi. Kutish vaqti tugashi yoki buzuq javob buyurtma mavjudligini aytmaydi. Uni keyingisiga yuborish ikki marta bajarish va ikki marta yechishga olib kelishi mumkin, shuning uchun marshrut toʻxtaydi va siz oʻsha buyurtmani hisobingizda tekshirasiz.
  • Bitta havolaga bitta faol buyurtma. Marshrutda biror havola uchun buyurtma bajarilayotgan paytda xuddi shu havola uchun ikkinchisi rad etiladi — provayderlarning oʻzlari ham shunday qiladi.
  • Bajarishdan oldingi bekor qilish ham keyingisiga oʻtishi mumkin, agar buni yoqgan boʻlsangiz. Qisman bajarilgan buyurtmaning bajarilmagan qismi faqat siz soʻragan boʻlsangiz keyingisiga oʻtadi.

Xatolar

XatoBu nimani anglatadi
Invalid API keyKalit notoʻgʻri, almashtirilgan yoki bekor qilingan.
This key is limited to certain addresses…Soʻrov kalit roʻyxatida boʻlmagan manzildan keldi.
Incorrect requestNomaʼlum action.
Incorrect service IDSizda bu ID raqamli marshrut yoʻq. Oʻchirilgan marshrut oʻz raqamini saqlaydi va u hech qachon boshqasiga berilmaydi.
Incorrect order IDSizda bu raqamli buyurtma yoʻq.
Link is required, Quantity is requiredSoʻrovdagi add maydonlaridan biri yoʻq yoki son emas.
A route takes a link and a quantity onlySoʻrovda drip-feed, izohlar yoki boshqa qoʻshimcha maydon bor edi.
This route is switched offBuni hisobingizda yoqing.
This route already has an order for this link…Joriy buyurtma tugashini kuting.
No step of this route can take this order right now. …Hech narsa yuborilmasdan oldin barcha qadamlar oʻtkazib yuborildi. Matnda har bir panel va uning sababi koʻrsatiladi.
No step of this route accepted the order. …Soʻralgan barcha qadamlar rad etdi. Hech narsa yechilmadi.
Too many requests…Quyidagi limitdan oshdi. Bir daqiqa kuting.

Misollar

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

Har bir add soʻroviga doim 30 soniya ichida javob beriladi. Marshrut bir nechta provayderdan birin-ketin soʻrashi mumkin; har biri shu vaqtning qolganini oladi, kutib boʻlmaydigan provayderdan esa umuman soʻralmaydi. Vaqt tugaganda oxirgi soʻralgan provayder javob bermagan boʻlsa, sizga Pending holatidagi buyurtma raqami beriladi va javob maʼlum boʻlguncha marshrut shu yerda toʻxtaydi. Aksariyat buyurtmalarga bir-ikki soniyada javob beriladi.

Limitlar va xavfsizlik

  • Har bir kalit uchun daqiqasiga 300 ta soʻrov, ulardan 120 tasi buyurtmalar. Bitta soʻrovda 100 tagacha buyurtma ID status soʻrovi.
  • Kalit bir marta koʻrsatiladi va iz (fingerprint) sifatida saqlanadi. Uni na siz, na biz qayta oʻqiy olmaymiz. Almashtirilganda eskisi darhol oʻchadi.
  • Ruxsat etilgan manzillar. Hisobingizda panelingiz serveri manzilini kiriting — kalit boshqa hech qayerdan ishlamaydi.
  • Marshrut ID raqami sir emas va sir boʻlishi shart ham emas. U faqat marshrut egasi boʻlgan hisob kaliti bilan birga ishlaydi.
  • Limitlaringiz amal qilishda davom etadi. Har bir panelning kunlik limiti, marshrutning oʻz kunlik limiti va eng katta buyurtmasi API orqali kelgan buyurtmalarga ham qoʻlda berganlaringizga qanday boʻlsa, xuddi shunday qoʻllanadi.
  • Pul hech qachon smm.guide orqali oʻtmaydi. Har bir buyurtma uni qabul qilgan paneldagi balansingizdan toʻlanadi. Qaytarishlar va nizolar siz bilan oʻsha panel oʻrtasida qoladi.

Katalogni oʻqimoqchimisiz?

Panellar, Trust Score va jonli narxlar uchun alohida API hamda yordamchilar uchun MCP server bor.