Программный интерфейс

Справочник программного интерфейса: адрес, авторизация по ключу, все методы с параметрами и примерами ответов, совместимость со стандартом SMM-панелей.

Общие правила

Адрес: https://webkit.guru/api/v2
Метод: POST, тело в формате application/x-www-form-urlencoded или JSON.
Ключ передаётся параметром key в каждом запросе. Получить и перевыпустить его можно в настройках кабинета.
Ответ всегда в JSON. Ошибка приходит объектом с полем error.
Интерфейс совместим со стандартом, принятым в SMM-панелях: готовые библиотеки и модули для CMS работают без переделки.

Список услуг

Запрос

curl -X POST https://webkit.guru/api/v2 \
  -d "key=ВАШ_КЛЮЧ" \
  -d "action=services"

Ответ

[
  {
    "service": 1287,
    "name": "Telegram Channel Members [Real]",
    "type": "Default",
    "category": "Telegram",
    "rate": "790.00",
    "min": 100,
    "max": 100000,
    "refill": true,
    "cancel": true
  }
]

Поле rate — цена за 1000 единиц в рублях, уже с учётом вашего уровня. Поля refill и cancel показывают, доступны ли для услуги восполнение и отмена: проверяйте их перед тем, как показывать соответствующие кнопки у себя.

Баланс

curl -X POST https://webkit.guru/api/v2 \
  -d "key=ВАШ_КЛЮЧ" \
  -d "action=balance"

{ "balance": "1543.20", "currency": "RUB" }

Создание заказа

Параметр	Обязателен	Описание
key	да	Ключ доступа
action	да	add
service	да	Числовой идентификатор услуги из метода services
link	да	Ссылка на объект
quantity	да	Количество; должно попадать в пределы min и max услуги
runs	нет	Число порций дозированной выдачи, от 2 до 100
interval	нет	Интервал между порциями в минутах, от 5 до 1440

curl -X POST https://webkit.guru/api/v2 \
  -d "key=ВАШ_КЛЮЧ" \
  -d "action=add" \
  -d "service=1287" \
  -d "link=https://t.me/example" \
  -d "quantity=1000"

{ "order": 48213 }

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

Один заказ запрашивается параметром order, несколько — параметром orders со списком номеров через запятую. Массовый запрос предпочтительнее: он экономит и ваши обращения, и лимит частоты.

curl -X POST https://webkit.guru/api/v2 \
  -d "key=ВАШ_КЛЮЧ" \
  -d "action=status" \
  -d "orders=48213,48214"

{
  "48213": {
    "charge": "790.00",
    "start_count": "12400",
    "status": "completed",
    "remains": "0",
    "currency": "RUB"
  }
}

Восполнение и отмена

action	Параметры	Ответ
refill	order или orders	{ "refill": 1201 }
refill_status	refill или refills	{ "status": "Completed" }
cancel	order или orders	Список результатов по каждому заказу