Асосӣ / Барои барномасозон / Orders API
Orders API
smm.guide-ро ба панели худ ҳамчун таъминкунанда илова кунед. Ҳар маршруте, ки шумо дар ҳисоби худ месозед, хизмат бо ID-и худ аст: панели шумо фармоишро ба он ID мефиристад ва маршрут онро ба аввалин таъминкунандаи шумо, ки онро қабул карда метавонад, месупорад.
Се қадам
Формат ҳамонест, ки SMM-панелҳо аллакай байни худ истифода мебаранд, бинобар ин ҳеҷ чиз барномасозӣ кардан лозим нест.
https://smm.guide/api/v2 ва калид. Хизматҳоро импорт кунед: маршрутҳои шумо бо ID, нарх ва лимитҳои худ меоянд.Формати дархост
| Методи HTTP | POST |
| URL-и API | 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 он қисмест, ки иҷро нашуд. Он чиро, ки ҳар қадам иҷро кард, ҳисоб мекунад: вақте ки як қадам қисмеро иҷро кард ва боқимонда дар қадами навбатӣ бекор шуд, фармоиш Partial аст, на Canceled. Дар бораи баргардонидани боқимондаи маблағ таъминкунанда қарор мекунад. |
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 барои ёрдамчиён.