Orders API

Додайте smm.guide у свою панель як постачальника. Кожен маршрут, який ви створюєте в акаунті, — це послуга з власним ID: ваша панель надсилає замовлення на цей ID, а маршрут передає його першому з ваших постачальників, який може його взяти.

Три кроки

Це той самий формат, який SMM-панелі вже використовують між собою, тож програмувати нічого не потрібно.

1Створіть маршрутАкаунт, Orders desk, Маршрути. Виберіть, що він виконує, і додайте до п’яти послуг цього виду з підключених панелей.
2Створіть ключOrders desk, Orders API. Ключ показується один раз. Його можна обмежити адресою сервера вашої панелі.
3Додайте постачальника у своїй панеліURL API https://smm.guide/api/v2 і ключ. Імпортуйте послуги: ваші маршрути з’являться зі своїми ID, цінами й лімітами.

Формат запиту

HTTP-методPOST
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-сервер для асистентів.