Перейти к содержимому

API для реселлеров и своих скриптов

Коротко: отправьте запрос POST с вашим ключом и названием действия на адрес API SMMVia и прочитайте ответ в JSON. Действий всего пять: balance, services, add, status и cancel.

Последнее обновление

POSThttps://smmvia.com/api/v2

API нужен тем, кто перепродаёт услуги в своей SMM-панели, в Телеграм-боте или автоматизирует заказы скриптом. На этой странице — путь от регистрации до первого заказа, который вы отслеживаете программно. Все параметры и тексты ошибок собраны в справочнике, а готовый код на нескольких языках — в примерах.

Пять действий и зачем они нужны

Действие Для чего Дополнительные поля
balance Узнать, сколько денег на балансе аккаунта. нет
services Получить номера услуг, вашу цену за 1000, минимум, максимум и признак отмены. нет
add Создать один заказ. Стоимость списывается с баланса в том же запросе. service, link, quantity
status Узнать состояние одного заказа или сразу до 100. order или orders
cancel Остановить до 100 незавершённых заказов и вернуть на баланс невыполненную часть. orders (или order)

Первый заказ через API: по шагам

  1. Шаг 1: Зарегистрируйтесь

    Создайте аккаунт по почте и паролю и откройте раздел с настройками аккаунта и API. Ключ показан там.

  2. Шаг 2: Пополните баланс

    Каждый заказ оплачивается с баланса, минимальное пополнение — $5.00. Действия balance и services работают и при нулевом балансе, а add откажет.

  3. Шаг 3: Выберите услугу по номеру

    Вызовите services, найдите нужную строку и запомните номер услуги. Названия могут меняться, а номер — то, что вы передаёте в заказ.

  4. Шаг 4: Сделайте пробный заказ

    Вызовите add с полями service, link и quantity, количество — близкое к минимуму. Сохраните номер заказа из ответа.

  5. Шаг 5: Доведите его до конца

    Раз в несколько минут запрашивайте status, пока заказ не придёт в Completed, Partial, Canceled или Refunded.

cURLПроверить этот заказ
curl -s https://smmvia.com/api/v2 \
  --data "key=PASTE_YOUR_KEY" \
  --data "action=status" \
  --data "order=80412"
# reply: {"charge":"0.0500","start_count":0,"status":"Pending","remains":500,"currency":"USD"}

Услуга 205, заказ 80412 и суммы выше придуманы для примера. Подставляйте номера из своего списка услуг и из ответа на свой запрос add.

Где хранить ключ

Ключ API даёт доступ к вашему балансу, поэтому обращайтесь с ним как с паролем. Держите его в настройках сервера или в переменной окружения — не в коде страницы, не в мобильном приложении и не в открытом репозитории. Предпочитайте POST: при GET ключ попадает в адрес запроса, а адреса оседают в журналах.

Пропущенный, ошибочный или заменённый ключ, как и приостановленный аккаунт, дают один и тот же ответ — ошибку о неверном ключе. Если ключ утёк, создайте новый на странице аккаунта — старый перестанет работать сразу.

Как читать ответы

  • Ошибки приходят в виде {"error": "текст"} с кодом HTTP 200. Проверяйте наличие поля error в теле ответа, а не только код.
  • Больше 300 запросов в минуту на один ключ — и вы получите HTTP 429. Такой запрос ничего не сделал, поэтому повторить его через минуту можно без последствий.
  • Денежные значения — строки. У цены 4 знака после точки; у баланса и суммы заказа может быть до 8, чтобы очень маленькие заказы сохраняли точную стоимость.
  • Поле currency указывает единицу всех сумм. Сейчас это USD.

Как часто спрашивать статус

Мы обновляем данные о заказах примерно раз в минуту, поэтому более частые запросы только тратят ваш лимит. Достаточно спрашивать раз в 2–5 минут, передавать до 100 номеров за запрос и убирать заказ из списка, как только он завершён.

Сначала заказ проходит через Pending и Processing, затем выполняется и приходит к одному из финальных статусов: Completed, Partial, Canceled или Refunded. Одна ловушка: Canceled с ненулевым charge означает, что деньги ещё не вернулись, поэтому считайте такой заказ открытым, пока charge не станет нулевым. Подробности — в таблице статусов.

Повторы и двойные заказы

У действия add нет защиты от повторов: один и тот же запрос, отправленный дважды, — это два заказа и два списания. Если add не ответил вовремя или вернул ошибку сервера, сначала проверьте раздел заказов в кабинете или баланс и отправляйте запрос снова, только если заказ не создан.

Действия balance, services и status ничего не меняют, их можно повторять сколько угодно в пределах лимита.

Куда возвращаются деньги

Если заказ выполнен не полностью или вы его отменили, стоимость невыполненной части зачисляется на баланс SMMVia, а не на криптокошелёк. Расчёт показан на странице о возврате. Выполнение зависит и от правил Телеграма; что от нас не зависит, перечислено на странице об ограничениях.

Если вы перепродаёте услуги своим клиентам, имеет смысл применять у себя то же правило: клиент платит за выполненное, остаток возвращается. Цены за 1000 по всем услугам — в каталоге, а о пополнении баланса — на странице цен и оплаты.

Данные проверены:

Вопросы и ответы

Можно подключить SMMVia к своей SMM-панели как источник услуг?
Формат запросов и ответов повторяет привычную схему «API v2», которую понимает большинство SMM-панелей. Мы проверяли его своими клиентами на cURL, Python, PHP и Node, но не со всеми скриптами панелей, которые есть на рынке. Перед тем как пускать к нам поток заказов, разместите через свою панель один небольшой заказ.
Сколько запросов в минуту можно отправлять?
300 в минуту на один ключ, все действия вместе. Сверх лимита приходит HTTP 429 с короткой ошибкой в JSON, а сам запрос не выполняется.
Вы присылаете уведомления, когда меняется статус заказа?
Нет. API только отвечает на запросы и сам ничего не отправляет. Чтобы узнать статус, запрашивайте действие status — до 100 заказов за один раз.
Есть ли в API восстановление отписок или постепенная подача?
Нет. Ни одна текущая услуга не включает восстановление пропавших единиц, поэтому такого действия в API нет, а действие add не принимает параметры постепенной подачи.
Цены в API такие же, как на сайте?
Поле rate показывает вашу личную цену за 1000. Обычно она совпадает с ценой в каталоге, но индивидуальные цены и скидки отражаются только в вашем ответе, поэтому у разных аккаунтов она может отличаться.