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 денеси да окулат: cURL'га массив берилгенде PHP ушуну жөнөтөт
ЖоопJSON, дайыма HTTP 200 менен, окуй албаган дене же өтө чоң сурам үчүн да. Ката мындай болот: {"error": "…"}
АкчаАКШ доллары. Баалар 1 000 үчүн

Кызматтардын тизмеси

Азыр буйрутма кабыл ала турган маршруттарыңыз. Өчүрүлгөн же бардык кадамдары чыгып калган маршрут тизмеде жок.

ПараметрСүрөттөмө
keyAPI ачкычыңыз
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 болот.

Өчүрүлгөн же иштей ала турган бир да кадамы жок маршрут кайтып келгенге чейин бул тизмеден чыгарылат. Кызматтарын автоматтык түрдө шайкештештирген панель ошол эле убакытка ал кызматты өз тарабында өчүрөт, бул сизге керек нерсе: анын буйрутмалары баары бир четке кагылмак.

Буйрутма кошуу

ПараметрСүрөттөмө
keyAPI ачкычыңыз
actionadd
serviceМаршруттун ID'си, сегиз сан
linkБеттин, посттун же профилдин шилтемеси
quantityКеректүү сан

Жооп

{
  "order": 23501
}

Эч ким кабыл алган жок

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

Буйрутманы акыры кайсы жеткирүүчү аткарбасын, анын номери бүт мөөнөтү бою өзгөрбөйт. Маршрут шилтеме менен санды кабыл алат; акырындап берүү, комментарийлер жана башка кошумча талаалар четке кагылат.

Буйрутманын абалы

ПараметрСүрөттөмө
keyAPI ачкычыңыз
actionstatus
orderБуйрутманын ID'си

Жооп

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
ПараметрСүрөттөмө
keyAPI ачкычыңыз
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 сиздин акчаңызды кармабайт. Бул цифра маршруттарыңыздын артындагы панелдердеги баланстарыңыздын суммасы, долларда.

ПараметрСүрөттөмө
keyAPI ачкычыңыз
actionbalance

Жооп

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

Жокко чыгаруу

Азыр буйрутманы кармап турган жеткирүүчүгө өткөрүлөт, эгер анын кызматы жокко чыгарууну сунуштаса. Сиз жокко чыгарган буйрутма эч качан кийинки кадамга жөнөтүлбөйт.

ПараметрСүрөттөмө
keyAPI ачкычыңыз
actioncancel
ordersБуйрутмалардын ID'лери үтүр менен, 100 чейин

Жооп

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

Кайра толтуруу

Буйрутманы аткарган жеткирүүчүгө өткөрүлөт. Кайра толтуруу буйрутманын өз номери менен жүрөт.

ПараметрСүрөттөмө
keyAPI ачкычыңыз
actionrefill
orderБуйрутманын ID'си. Же orders: бир нечеси, үтүр менен бөлүнгөн

Жооп, бир буйрутма

{ "refill": "23501" }

Жооп, бир нече

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
ПараметрСүрөттөмө
keyAPI ачкычыңыз
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 сервери бар.