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

Готовые примеры: одна задача — один фрагмент кода

Каждый фрагмент ниже решает одну задачу. Ключ берётся из переменной окружения SMMVIA_KEY, чтобы он не попал в сам код. Услуга 205, заказы 80412 и 80413 и ссылка на пост придуманы для примера — подставьте значения из своего аккаунта. Помните, что настоящий вызов add тратит настоящий баланс.

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

POSThttps://smmvia.com/api/v2

Значение каждого поля описано в справочнике, общие правила работы — в обзоре API.

Задача 1: узнать баланс

Самый простой запрос — с него удобно проверить, что ключ работает. В версии на Python заодно объявлена функция via(), которая отправляет действие и выбрасывает исключение, если в ответе есть ошибка; она пригодится в задаче 4.

Задача 2: найти номер услуги

Отфильтруйте список по категории или названию в своём коде и сохраните номер услуги. Цена в поле rate — ваша личная цена за 1000.

PHPPHP (расширение curl)
<?php
function via(string $action, array $fields = []): array {
    $ch = curl_init('https://smmvia.com/api/v2');
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => 30,
        CURLOPT_POSTFIELDS => http_build_query(['key' => getenv('SMMVIA_KEY'), 'action' => $action] + $fields),
    ]);
    $reply = json_decode(curl_exec($ch), true);
    if (isset($reply['error'])) { throw new RuntimeException($reply['error']); }
    return $reply;
}

foreach (via('services') as $row) {
    echo $row['service'], '  ', $row['rate'], '  ', $row['min'], '-', $row['max'], '  ', $row['name'], PHP_EOL;
}

Задача 3: разместить один заказ

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

Node.jsNode 18+ (встроенный fetch)
const ENDPOINT = "https://smmvia.com/api/v2";

async function via(action, fields = {}) {
  const body = new URLSearchParams({ key: process.env.SMMVIA_KEY, action, ...fields });
  const reply = await (await fetch(ENDPOINT, { method: "POST", body })).json();
  if (reply && reply.error) throw new Error(reply.error);
  return reply;
}

const placed = await via("add", { service: "205", link: "https://t.me/your_channel/57", quantity: "100" });
console.log("new order", placed.order);

Задача 4: опрашивать статус до завершения

Один запрос status охватывает до 100 номеров. Спрашивайте раз в несколько минут и убирайте заказ из списка, когда он завершён. Заказ Canceled, у которого charge ещё больше нуля, не закрыт окончательно — оставьте его в цикле.

PythonPython, функция via() из задачи 1
import time

open_ids = {80412, 80413}
DONE = {"Completed", "Partial", "Refunded"}

while open_ids:
    batch = ",".join(str(i) for i in sorted(open_ids)[:100])
    reply = via("status", orders=batch) or {}   # [] when no ID matched
    for oid, info in reply.items():
        settled = info["status"] in DONE or (info["status"] == "Canceled" and float(info["charge"]) == 0)
        if settled:
            print(oid, info["status"], "undelivered:", info["remains"])
            open_ids.discard(int(oid))
    time.sleep(180)

Задача 5: отменить незавершённые заказы

Каждая строка ответа — либо 1 (заказ остановлен, невыполненная часть вернулась на баланс), либо ошибка для этого номера. Повторяйте только те строки, где текст ошибки просит повторить.

cURL
curl -s https://smmvia.com/api/v2 \
  --data "key=$SMMVIA_KEY" --data "action=cancel" --data "orders=80412,80413"

Перед запуском на реальных клиентах

  • Проверьте каждую услугу, которую собираетесь перепродавать, одним небольшим заказом.
  • Записывайте в журнал полный текст каждого ответа: ошибки приходят с кодом HTTP 200.
  • Держитесь в пределах 300 запросов в минуту на ключ и делайте паузу, получив HTTP 429.
  • Прочитайте правила возврата, чтобы ваши клиенты получали тот же расчёт, что и вы.

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