Orders API

Добавьте smm.guide в свою панель как поставщика. Каждый маршрут, созданный в вашем аккаунте, — это услуга со своим ID: ваша панель отправляет заказ на этот ID, а маршрут передаёт его первому из ваших поставщиков, который может его взять.

Три шага

Формат тот же, что SMM-панели уже используют между собой, поэтому программировать ничего не нужно.

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

Формат запроса

HTTP-методPOST
Адрес 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 — то, что не выполнено. Учитывается выполненное всеми шагами: если один шаг выполнил часть, а остальное отменили на следующем, заказ «Частично», а не «Отменён». О возврате остатка решает поставщик.
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-сервер для ассистентов.