Басты бет / Әзірлеушілерге / Orders API
Orders API
smm.guide-ты панеліңізге провайдер ретінде қосыңыз. Аккаунтыңызда жасаған әр маршрут — өз ID-і бар қызмет: панеліңіз тапсырысты сол ID-ге жібереді, ал маршрут оны провайдерлеріңіздің ішінен қабылдай алатын біріншісіне береді.
Үш қадам
Формат — SMM-панельдер өзара қолданып жүрген формат, сондықтан ештеңе бағдарламалаудың қажеті жоқ.
https://smm.guide/api/v2 және кілт. Қызметтерді импорттаңыз: маршруттарыңыз ID-лерімен, бағаларымен және шектеулерімен келеді.Сұраныс форматы
| HTTP әдісі | POST |
| API URL | https://smm.guide/api/v2 |
| Денесі | application/x-www-form-urlencoded, немесе JSON, мына тақырыппен: Content-Type: application/json. A multipart/form-data денесі де оқылады — PHP cURL-ге массив берілгенде дәл осыны жібереді |
| Жауап | JSON, әрдайым HTTP 200-мен, оқи алмайтын дене немесе тым үлкен сұраныс үшін де. Қате мына түрде болады: {"error": "…"} |
| Ақша | АҚШ доллары. Бағалар 1 000 данаға |
Қызметтер тізімі
Дәл қазір тапсырыс қабылдай алатын маршруттарыңыз. Өшірілген немесе барлық қадамдары істен шыққан маршрут тізімде көрсетілмейді.
| Параметр | Сипаттама |
|---|---|
key | Сіздің API кілтіңіз |
action | services |
Жауап
[
{
"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 — маршруттың тапсырыс қабылдай алатын қадамдарының ең қымбатының бағасы, уақытша өткізіліп жатқандары да есепке алынады (бүгін істен шыққан панель ертең қайтады), сондықтан тапсырыс панеліңіз импорттаған бағадан ешқашан қымбат тұрмайды. min және max — жұмыс істейтін қадамдардың бірлескен ең кең ауқымы; олардың тек кейбіріне сыятын сан солардың біріне жіберіледі. refill және cancel — осындай әр қадам ұсынса, true болады.
Өшірілген немесе жұмыс істей алатын қадамы жоқ маршрут қайта іске қосылғанша бұл тізімге кірмейді. Қызметтерін автоматты түрде синхрондайтын панель сол уақытқа өз жағында ол қызметті өшіреді — сізге керегі де осы: оның тапсырыстары бәрібір қабылданбас еді.
Тапсырыс қосу
| Параметр | Сипаттама |
|---|---|
key | Сіздің API кілтіңіз |
action | add |
service | Маршрут ID-і, сегіз сан |
link | Бетке, жазбаға немесе профильге сілтеме |
quantity | Қажетті саны |
Жауап
{
"order": 23501
}
Ешкім қабылдамады
{
"error": "No step of this route accepted the order. …"
}Тапсырыс нөмірі оны қай провайдер орындаса да, тапсырыстың бүкіл өмірінде өзгермейді. Маршрут сілтеме мен санды қабылдайды; біртіндеп беру, комментарийлер және басқа қосымша өрістер қабылданбайды.
Тапсырыс күйі
| Параметр | Сипаттама |
|---|---|
key | Сіздің API кілтіңіз |
action | status |
order | Тапсырыс ID-і |
Жауап
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| Параметр | Сипаттама |
|---|---|
key | Сіздің API кілтіңіз |
action | status |
orders | Үтірмен бөлінген тапсырыс ID-лері, 100 данаға дейін |
Жауап
{
"23501": {
"charge": "0.0045",
"start_count": "3572",
"status": "Completed",
"remains": "0",
"currency": "USD"
},
"99": { "error": "Incorrect order ID" }
}| Күйі | Мағынасы |
|---|---|
Pending | Провайдер қабылдады, әлі басталмаған. Сондай-ақ провайдер нақты жауап бермеген тапсырыс: оны аккаунтыңызда тексергенше маршрут сол жерде тоқтайды. |
In progress, Processing | Провайдер орындап жатыр немесе тапсырыс келесі қадамға жіберілуде. |
Completed | Толық орындалды. |
Partial | Ішінара орындалды; remains — орындалмаған бөлігі. Ол әр қадамның орындағанын есептейді: бір қадам бір бөлігін орындап, қалғаны келесі қадамда тоқтатылса, тапсырыс Canceled емес, Partial болады. Ақының қалған бөлігін қайтару туралы провайдер шешеді. |
Canceled | Ештеңе орындалмады және тапсырысты басқа ешбір қадам қабылдамады. charge — есептен шығарылған сома қалса, соны көрсетеді. |
charge — провайдерлер осы тапсырыс үшін алған сома, тапсырыс берілген күнгі бағам бойынша долларда. start_count — оны бастаған провайдерден алынады.
Баланс
smm.guide сіздің ақшаңызды ұстамайды. Бұл сан — маршруттарыңыздың артындағы панельдердегі балансыңыздың долларлық жиыны.
| Параметр | Сипаттама |
|---|---|
key | Сіздің API кілтіңіз |
action | balance |
Жауап
{
"balance": "126.1375",
"currency": "USD"
}Бас тарту
Қазір тапсырысты ұстап тұрған провайдерге жіберіледі, егер оның қызметінде бас тарту мүмкіндігі болса. Сіз бас тартқан тапсырыс ешқашан келесі қадамға жіберілмейді.
| Параметр | Сипаттама |
|---|---|
key | Сіздің API кілтіңіз |
action | cancel |
orders | Үтірмен бөлінген тапсырыс ID-лері, 100 данаға дейін |
Жауап
[
{ "order": 23501, "cancel": 1 },
{ "order": 23502, "cancel": { "error": "The order is already finished" } }
]Қайта толтыру
Тапсырысты орындаған провайдерге жіберіледі. Қайта толтыру тапсырыстың өз нөмірімен жүреді.
| Параметр | Сипаттама |
|---|---|
key | Сіздің API кілтіңіз |
action | refill |
order | Тапсырыс ID-і. Немесе orders: бірнешеуі, үтірмен бөлінген |
Жауап, бір тапсырыс
{ "refill": "23501" }
Жауап, бірнеше тапсырыс
[
{ "order": 23501, "refill": 23501 },
{ "order": 23502, "refill": { "error": "…" } }
]| Параметр | Сипаттама |
|---|---|
key | Сіздің API кілтіңіз |
action | refill_status |
refill | Қайта толтыру ID-і. Немесе refills: бірнешеуі, үтірмен бөлінген |
Жауап
{ "status": "Completed" }Маршрут тапсырыспен не істейді
- Қадамдар сіздің ретіңізбен немесе алдымен ең арзан жұмыс істейтіні бойынша сыналады. Қайсысы екенін маршрутта таңдайсыз.
- Қадам өткізіліп жіберіледі, егер оның панелі жауап бермесе, балансы немесе күндік лимиті тапсырысты жаппаса, саны ол қабылдайтын шектен тыс болса, бағасы сіз қойған шектен жоғары болса немесе оның бағасымен тапсырыс маршруттың өз күндік лимитінен асып кетсе. Ол өздігінен қайтады.
- Қадам шығып қалады, егер оның қызметі прайс-листтен шықса немесе панель сол ID-мен басқа нәрсе сата бастаса. Басқа қадамдар жұмысын жалғастырады, ал сізге хабарланады.
- Бас тарту тапсырысты әрі қарай жібереді. Панель жауап беріп, бас тартса, ештеңе есептен шығарылмаған, сондықтан келесі қадам сыналады.
- Нақты жауаптың болмауы оны тоқтатады. Күту уақытының өтуі немесе бұзылған жауап тапсырыстың бар-жоғын білдірмейді. Оны әрі қарай жіберсе, екі рет орындалып, екі рет ақы алынуы мүмкін, сондықтан маршрут тоқтайды, ал сіз сол бір тапсырысты аккаунтыңызда тексересіз.
- Бір сілтемеге бір белсенді тапсырыс. Маршрутта бір сілтемеге тапсырыс орындалып жатқанда, сол сілтемеге екінші тапсырыс қабылданбайды — провайдерлердің өздері де солай істейді.
- Орындалғанға дейінгі бас тарту да әрі қарай жіберілуі мүмкін, егер сіз мұны қоссаңыз. Ішінара тапсырыстың орындалмай қалған бөлігі тек сіз сұрасаңыз ғана әрі қарай жіберіледі.
Қателер
| Қате | Нені білдіреді |
|---|---|
Invalid API key | Кілт қате, ауыстырылған немесе күші жойылған. |
This key is limited to certain addresses… | Сұраныс кілттің тізімінде жоқ мекенжайдан келді. |
Incorrect request | Белгісіз action. |
Incorrect service ID | Бұл ID-мен сізде маршрут жоқ. Жойылған маршрут өз нөмірін сақтайды және ол ешқашан басқаға берілмейді. |
Incorrect order ID | Бұл нөмірмен сізде тапсырыс жоқ. |
Link is required, Quantity is required | Мына өрістердің бірі: add — жоқ немесе сан емес. |
A route takes a link and a quantity only | Сұраныста біртіндеп беру, комментарийлер немесе басқа қосымша өріс болды. |
This route is switched off | Оны аккаунтыңызда қосыңыз. |
This route already has an order for this link… | Орындалып жатқаны аяқталғанша күтіңіз. |
No step of this route can take this order right now. … | Ештеңе жіберілмей тұрып әр қадам өткізіліп жіберілді. Мәтінде әр панель мен оның себебі аталады. |
No step of this route accepted the order. … | Сұралған әр қадам бас тартты. Ештеңе есептен шығарылмады. |
Too many requests… | Төмендегі лимиттен асты. Бір минут күтіңіз. |
Мысалдар
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]);
Әр add сұранысына әрдайым 30 секунд ішінде жауап беріледі. Маршрут бірнеше провайдерден кезекпен сұрауы мүмкін; әрқайсысы сол уақыттың қалғанын алады, ал күтуге уақыт жетпейтін провайдерден мүлде сұралмайды. Уақыт біткенде соңғы сұралған провайдер әлі жауап бермесе, Pending күйімен тапсырыс нөмірін аласыз, ал маршрут жауап белгілі болғанша сол жерде тоқтайды. Тапсырыстардың көбіне бір-екі секундта жауап беріледі.
Лимиттер және қауіпсіздік
- Бір кілтке минутына 300 сұрау, оның ішінде 120 тапсырыс. Бір сұрауда ең көбі 100 тапсырыс ID
statusшақыру. - Кілт бір рет көрсетіледі және із ретінде сақталады. Оны сіз де, біз де қайта оқи алмаймыз. Оны ауыстырсаңыз, ескісі бірден өшіріледі.
- Рұқсат етілген мекенжайлар. Аккаунтыңызда панель серверінің мекенжайын көрсетіңіз, сонда кілт басқа еш жерден жұмыс істемейді.
- Маршрут ID-і құпия емес және құпия болуы қажет те емес. Ол тек маршрут иесі аккаунттың кілтімен бірге жұмыс істейді.
- Лимиттеріңіз күшінде қалады. Әр панельдің күндік лимиті, маршруттың өз күндік лимиті және оның ең үлкен тапсырысы API арқылы келетін тапсырыстарға да қолмен берілетіндерге қалай қолданылса, дәл солай қолданылады.
- Ақша ешқашан smm.guide арқылы өтпейді. Әр тапсырыс оны қабылдаған панельдегі балансыңыздан төленеді. Қаражатты қайтару мен даулар сіз бен сол панель арасында қалады.
Каталогты оқу керек пе?
Панельдердің, Trust Score көрсеткіштерінің және нақты уақыттағы бағалардың өз API-і және көмекшілерге арналған MCP сервері бар.