API v2

API для реселлеров

Подключите наши услуги к своей SMM-панели. Формат запросов и ответов стандартный — работает с Perfect Panel, SmartPanel и любой панелью с поддержкой провайдеров v2.

Получить API-ключ Список услуг

Адрес API: https://atwitch.ru/api/v2
Метод: POST или GET
Ответ: JSON
Валюта: USD · RUB/EUR в кабинете

Быстрый старт

Ключ. Создайте его в личном кабинете → API. Там же выбираются валюта и язык ответов.
Баланс. Заказы оплачиваются с баланса аккаунта — пополните его заранее.
Запрос. Каждый запрос — это key + action + параметры метода. Можно слать как форму или как JSON.

PHP

<?php
$ch = curl_init('https://atwitch.ru/api/v2');
curl_setopt_array($ch, [
  CURLOPT_POST           => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POSTFIELDS     => http_build_query([
    'key'      => 'YOUR_API_KEY',
    'action'   => 'add',
    'service'  => 1234,
    'link'     => 'https://www.twitch.tv/channel',
    'quantity' => 100,
  ]),
]);
$order = json_decode(curl_exec($ch), true);
// ['status' => 'success', 'order' => 32]

Создать заказ action=add

Оформляет заказ и списывает стоимость с баланса. Набор полей зависит от типа услуги — выберите тип ниже.

Параметр	Описание
`key` обязательный	Ваш API-ключ
`action` обязательный	`add`
`service` обязательный	ID услуги из списка services
`link` обязательный	Ссылка на канал, стрим или видео
`quantity` обязательный	Количество
`runs` необязательный	Количество запусков (drip-feed)
`interval` необязательный	Интервал между запусками, минуты

Запрос · cURL

curl -X POST https://atwitch.ru/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=add \
  -d service=1234 \
  -d link=https://www.twitch.tv/channel \
  -d quantity=100

Ответ · JSON

{
  "status": "success",
  "order": 32
}

Статус заказа action=status

Текущее состояние одного заказа: сколько выполнено и сколько списано.

Параметр	Описание
`key` обязательный	Ваш API-ключ
`action` обязательный	`status`
`order` обязательный	ID заказа

Запрос · cURL

curl -X POST https://atwitch.ru/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=status \
  -d order=32

Ответ · JSON

{
  "order": 32,
  "status": "In progress",
  "start_count": 0,
  "remains": 0,
  "charge": 0.036,
  "currency": "USD"
}

Статус нескольких заказов action=status

Несколько заказов одним запросом. Ответ — объект, где ключ — ID заказа.

Параметр	Описание
`key` обязательный	Ваш API-ключ
`action` обязательный	`status`
`orders` обязательный	ID заказов через запятую или массив

Запрос · cURL

curl -X POST https://atwitch.ru/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=status \
  -d orders=12,13,2

Ответ · JSON

{
  "12": {
    "order": 12,
    "status": "Processing",
    "start_count": 0,
    "remains": 0,
    "charge": 1.26,
    "currency": "USD"
  },
  "13": {
    "order": 13,
    "status": "Completed",
    "start_count": 0,
    "remains": 0,
    "charge": 0.63,
    "currency": "USD"
  },
  "2": {
    "error": "Order not found"
  }
}

Список услуг action=services

Все услуги, доступные по API, с ценой за 1000 в валюте вашего аккаунта. Список обновляется раз в сутки — кэшируйте его у себя.

Параметр	Описание
`key` обязательный	Ваш API-ключ
`action` обязательный	`services`

Запрос · cURL

curl -X POST https://atwitch.ru/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=services

Ответ · JSON

[
  {
    "service": 1234,
    "name": "Twitch Viewers — 1 hour",
    "type": "Default",
    "category": "Twitch > Viewers",
    "desc": "Start: 0-15 min",
    "rate": 0.264,
    "min": 10,
    "max": 5000,
    "multiple": 0,
    "dripfeed": false,
    "refill": false
  }
]

Баланс action=balance

Остаток на счёте вместе с бонусными баллами.

Параметр	Описание
`key` обязательный	Ваш API-ключ
`action` обязательный	`balance`

Запрос · cURL

curl -X POST https://atwitch.ru/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=balance

Ответ · JSON

{
  "status": "success",
  "balance": 100.84,
  "currency": "USD"
}

Статусы заказа

Pending Принят, ждёт запуска
In progress Запускается
Processing Выполняется
Completed Выполнен
Partial Выполнен частично
Canceled Отменён

Ошибки

При ошибке приходит {"error": "…"} — текст всегда на английском, чтобы панель могла его разобрать.

Parameter `key` is required	Не передан ключ
`API is disable for this User or User not found! Contact the Support`	Ключ неверный или API для аккаунта выключен — напишите в поддержку
Parameter `action` is required	Не передан action
`This action method not allowed`	Такого action нет
Parameter `service` is required	Не передан service
`Duplicate url, please try again later`	По этой ссылке уже есть свежие заказы — повторите позже
Incorrect request parameter `order` or `orders`	Не передан order или orders
`Order not found`	Заказ не найден среди ваших

type: default