Orders API

smm.guide-ты панеліңізге провайдер ретінде қосыңыз. Аккаунтыңызда жасаған әр маршрут — өз ID-і бар қызмет: панеліңіз тапсырысты сол ID-ге жібереді, ал маршрут оны провайдерлеріңіздің ішінен қабылдай алатын біріншісіне береді.

Үш қадам

Формат — SMM-панельдер өзара қолданып жүрген формат, сондықтан ештеңе бағдарламалаудың қажеті жоқ.

1Маршрут жасаңызАккаунт, Orders desk, Маршруттар. Оның не орындайтынын таңдап, қосылған панельдеріңізден сол түрдегі бес қызметке дейін қосыңыз.
2Кілт жасаңызOrders desk, Orders API. Кілт бір рет көрсетіледі. Оны панеліңіз серверінің мекенжайымен шектей аласыз.
3Панеліңізге провайдер қосыңызAPI URL https://smm.guide/api/v2 және кілт. Қызметтерді импорттаңыз: маршруттарыңыз ID-лерімен, бағаларымен және шектеулерімен келеді.

Сұраныс форматы

HTTP әдісіPOST
API URLhttps://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 кілтіңіз
actionservices

Жауап

[
  {
    "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 кілтіңіз
actionadd
serviceМаршрут ID-і, сегіз сан
linkБетке, жазбаға немесе профильге сілтеме
quantityҚажетті саны

Жауап

{
  "order": 23501
}

Ешкім қабылдамады

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

Тапсырыс нөмірі оны қай провайдер орындаса да, тапсырыстың бүкіл өмірінде өзгермейді. Маршрут сілтеме мен санды қабылдайды; біртіндеп беру, комментарийлер және басқа қосымша өрістер қабылданбайды.

Тапсырыс күйі

ПараметрСипаттама
keyСіздің API кілтіңіз
actionstatus
orderТапсырыс ID-і

Жауап

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
ПараметрСипаттама
keyСіздің API кілтіңіз
actionstatus
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 кілтіңіз
actionbalance

Жауап

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

Бас тарту

Қазір тапсырысты ұстап тұрған провайдерге жіберіледі, егер оның қызметінде бас тарту мүмкіндігі болса. Сіз бас тартқан тапсырыс ешқашан келесі қадамға жіберілмейді.

ПараметрСипаттама
keyСіздің API кілтіңіз
actioncancel
ordersҮтірмен бөлінген тапсырыс ID-лері, 100 данаға дейін

Жауап

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

Қайта толтыру

Тапсырысты орындаған провайдерге жіберіледі. Қайта толтыру тапсырыстың өз нөмірімен жүреді.

ПараметрСипаттама
keyСіздің API кілтіңіз
actionrefill
orderТапсырыс ID-і. Немесе orders: бірнешеуі, үтірмен бөлінген

Жауап, бір тапсырыс

{ "refill": "23501" }

Жауап, бірнеше тапсырыс

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
ПараметрСипаттама
keyСіздің API кілтіңіз
actionrefill_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 сервері бар.