Главная / Разработчикам / Orders API
Orders API
Добавьте smm.guide в свою панель как поставщика. Каждый маршрут, созданный в вашем аккаунте, — это услуга со своим ID: ваша панель отправляет заказ на этот ID, а маршрут передаёт его первому из ваших поставщиков, который может его взять.
Три шага
Формат тот же, что SMM-панели уже используют между собой, поэтому программировать ничего не нужно.
https://smm.guide/api/v2 и ключ. Импортируйте услуги: ваши маршруты придут со своими ID, ценами и лимитами.Формат запроса
| HTTP-метод | POST |
| Адрес 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 — то, что не выполнено. Учитывается выполненное всеми шагами: если один шаг выполнил часть, а остальное отменили на следующем, заказ «Частично», а не «Отменён». О возврате остатка решает поставщик. |
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-сервер для ассистентов.