Orders API

smm.guide-ро ба панели худ ҳамчун таъминкунанда илова кунед. Ҳар маршруте, ки шумо дар ҳисоби худ месозед, хизмат бо ID-и худ аст: панели шумо фармоишро ба он ID мефиристад ва маршрут онро ба аввалин таъминкунандаи шумо, ки онро қабул карда метавонад, месупорад.

Се қадам

Формат ҳамонест, ки SMM-панелҳо аллакай байни худ истифода мебаранд, бинобар ин ҳеҷ чиз барномасозӣ кардан лозим нест.

1Маршрут созедҲисоб, Orders desk, Маршрутҳо. Интихоб кунед, ки он чӣ иҷро мекунад ва то панҷ хизмати ҳамин намудро аз панелҳои пайвастшудаи худ илова кунед.
2Калид созедOrders desk, Orders API. Калид як бор нишон дода мешавад. Шумо метавонед онро бо суроғаи сервери панели худ маҳдуд кунед.
3Дар панели худ таъминкунанда илова кунедURL-и API https://smm.guide/api/v2 ва калид. Хизматҳоро импорт кунед: маршрутҳои шумо бо ID, нарх ва лимитҳои худ меоянд.

Формати дархост

Методи HTTPPOST
URL-и APIhttps://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
serviceID-и маршрут, ҳашт рақам
linkПайванд ба саҳифа, пост ё профил
quantityМиқдори лозимӣ

Ҷавоб

{
  "order": 23501
}

Ҳеҷ кас қабул накард

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

Рақами фармоиш дар тӯли тамоми умри фармоиш, новобаста аз он ки кадом таъминкунанда онро иҷро мекунад, ҳамон мемонад. Маршрут пайванд ва миқдорро қабул мекунад; додани тадриҷӣ, коментарияҳо ва дигар майдонҳои иловагӣ рад карда мешаванд.

Ҳолати фармоиш

ПараметрТавсиф
keyКалиди API-и шумо
actionstatus
orderID-и фармоиш

Ҷавоб

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
ПараметрТавсиф
keyКалиди API-и шумо
actionstatus
ordersID-ҳои фармоиш бо вергул ҷудо карда шуда, то 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 он қисмест, ки иҷро нашуд. Он чиро, ки ҳар қадам иҷро кард, ҳисоб мекунад: вақте ки як қадам қисмеро иҷро кард ва боқимонда дар қадами навбатӣ бекор шуд, фармоиш Partial аст, на Canceled. Дар бораи баргардонидани боқимондаи маблағ таъминкунанда қарор мекунад.
CanceledҲеҷ чиз иҷро нашуд ва ягон қадами дигар фармоишро нагирифт. charge нишон медиҳад, ки чӣ қадар маблағ гирифта шуда монд, агар монда бошад.

charge маблағест, ки таъминкунандагон барои ин фармоиш гирифтанд, бо доллар бо қурби рӯзи додани фармоиш. start_count аз таъминкунандае меояд, ки онро оғоз кардааст.

Баланс

smm.guide пули шуморо нигоҳ намедорад. Ин рақам ҷамъи балансҳои шумо дар панелҳои паси маршрутҳои шумост, бо доллар.

ПараметрТавсиф
keyКалиди API-и шумо
actionbalance

Ҷавоб

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

Бекор кардан

Ба таъминкунандае фиристода мешавад, ки ҳоло фармоишро дорад, агар хизмати он бекоркуниро пешниҳод кунад. Фармоише, ки шумо бекор мекунед, ҳеҷ гоҳ ба қадами навбатӣ фиристода намешавад.

ПараметрТавсиф
keyКалиди API-и шумо
actioncancel
ordersID-ҳои фармоиш бо вергул ҷудо карда шуда, то 100

Ҷавоб

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

Барқарорсозӣ

Ба таъминкунандае фиристода мешавад, ки фармоишро иҷро кардааст. Барқарорсозӣ рақами худи фармоишро дорад.

ПараметрТавсиф
keyКалиди API-и шумо
actionrefill
orderID-и фармоиш. Ё orders: якчанд, бо вергул ҷудо карда шуда

Ҷавоб, як фармоиш

{ "refill": "23501" }

Ҷавоб, якчанд

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
ПараметрТавсиф
keyКалиди API-и шумо
actionrefill_status
refillID-и барқарорсозӣ. Ё 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 барои ёрдамчиён.