Bosh sahifa / Dasturchilar uchun / Orders API
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.
https://smm.guide/api/v2 va kalitni kiriting. Xizmatlarni import qiling: marshrutlaringiz ID raqamlari, narxlari va limitlari bilan keladi.Soʻrov formati
| HTTP metodi | POST |
| API URL | https://smm.guide/api/v2 |
| Tana | application/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 |
| Javob | JSON, doim HTTP 200 bilan, hatto biz oʻqiy olmaydigan tana yoki juda katta soʻrov uchun ham. Xato quyidagicha: {"error": "…"} |
| Pul | AQSh 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.
| Parametr | Tavsif |
|---|---|
key | API kalitingiz |
action | services |
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
| Parametr | Tavsif |
|---|---|
key | API kalitingiz |
action | add |
service | Marshrut ID raqami, sakkiz xonali |
link | Sahifa, post yoki profilga havola |
quantity | Kerakli 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
| Parametr | Tavsif |
|---|---|
key | API kalitingiz |
action | status |
order | Buyurtma ID |
Javob
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| Parametr | Tavsif |
|---|---|
key | API kalitingiz |
action | status |
orders | Vergul 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" }
}| Holat | Maʼnosi |
|---|---|
Pending | Provayder qabul qilgan, lekin hali boshlanmagan. Shuningdek, provayder aniq javob bermagan buyurtma ham: siz uni hisobingizda tekshirmaguningizcha marshrut shu yerda toʻxtaydi. |
In progress, Processing | Provayder uni bajarmoqda yoki buyurtma keyingi qadamga yoʻl olmoqda. |
Completed | Toʻliq bajarildi. |
Partial | Qisman 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. |
Canceled | Hech 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.
| Parametr | Tavsif |
|---|---|
key | API kalitingiz |
action | balance |
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.
| Parametr | Tavsif |
|---|---|
key | API kalitingiz |
action | cancel |
orders | Vergul 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.
| Parametr | Tavsif |
|---|---|
key | API kalitingiz |
action | refill |
order | Buyurtma ID. Yoki orders: bir nechtasi, vergul bilan ajratilgan |
Javob, bitta buyurtma
{ "refill": "23501" }
Javob, bir nechta
[
{ "order": 23501, "refill": 23501 },
{ "order": 23502, "refill": { "error": "…" } }
]| Parametr | Tavsif |
|---|---|
key | API kalitingiz |
action | refill_status |
refill | Qayta 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
| Xato | Bu nimani anglatadi |
|---|---|
Invalid API key | Kalit notoʻgʻri, almashtirilgan yoki bekor qilingan. |
This key is limited to certain addresses… | Soʻrov kalit roʻyxatida boʻlmagan manzildan keldi. |
Incorrect request | Nomaʼlum action. |
Incorrect service ID | Sizda bu ID raqamli marshrut yoʻq. Oʻchirilgan marshrut oʻz raqamini saqlaydi va u hech qachon boshqasiga berilmaydi. |
Incorrect order ID | Sizda bu raqamli buyurtma yoʻq. |
Link is required, Quantity is required | Soʻrovdagi add maydonlaridan biri yoʻq yoki son emas. |
A route takes a link and a quantity only | Soʻrovda drip-feed, izohlar yoki boshqa qoʻshimcha maydon bor edi. |
This route is switched off | Buni 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
statussoʻ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.