Ana səhifə / Tərtibatçılar / Orders API
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.
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 metodu | POST |
| API URL | https://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 |
| Cavab | JSON, 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": "…"} |
| Pul | ABŞ 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.
| Parametr | Təsvir |
|---|---|
key | API açarınız |
action | services |
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
| Parametr | Təsvir |
|---|---|
key | API açarınız |
action | add |
service | Marşrutun ID-si, səkkiz rəqəm |
link | Səhifəyə, paylaşıma və ya profilə keçid |
quantity | Lazı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
| Parametr | Təsvir |
|---|---|
key | API açarınız |
action | status |
order | Sifariş ID-si |
Cavab
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| Parametr | Təsvir |
|---|---|
key | API açarınız |
action | status |
orders | Vergü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" }
}| Status | Mənası |
|---|---|
Pending | Provayder 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, Processing | Provayder onu yerinə yetirir və ya sifariş növbəti addıma keçir. |
Completed | Tam yerinə yetirilib. |
Partial | Qismə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. |
Canceled | Heç 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.
| Parametr | Təsvir |
|---|---|
key | API açarınız |
action | balance |
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.
| Parametr | Təsvir |
|---|---|
key | API açarınız |
action | cancel |
orders | Vergü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.
| Parametr | Təsvir |
|---|---|
key | API açarınız |
action | refill |
order | Sifariş 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": "…" } }
]| Parametr | Təsvir |
|---|---|
key | API açarınız |
action | refill_status |
refill | Bə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əta | Nə deməkdir |
|---|---|
Invalid API key | Aç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 request | Naməlum action. |
Incorrect service ID | Bu 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 ID | Bu nömrə ilə sifarişiniz yoxdur. |
Link is required, Quantity is required | Bu sahələrdən biri — add — yoxdur və ya rəqəm deyil. |
A route takes a link and a quantity only | Sorğuda drip-feed, şərhlər və ya başqa əlavə sahə var idi. |
This route is switched off | Onu 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
statussorğ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.