На этой странице

Документация API SMM-панели

Версия API: v2

SmmFoxi предоставляет стандартный API SMM-панели (v2), чтобы вы могли интегрировать 373 услуг социального маркетинга прямо в свою реселлерскую панель, бота или приложение. Быстрый старт по подходящим услугам, конкурентные цены и полная автоматизация. Эта документация охватывает все доступные конечные точки и их использование.

Перед началом: доступ к API за 4 шага

Для первого запроса нужны аккаунт, пополненный баланс и API-ключ. Настройка занимает несколько минут:

  1. 1

    Создайте аккаунт

    Зарегистрируйтесь в SmmFoxi. Один и тот же аккаунт используется в веб-панели и в API.

    Регистрация →
  2. 2

    Пополните баланс

    Заказы через API оплачиваются с баланса аккаунта. Пополните его в панели; проверить баланс можно в любой момент через action=balance.

    Открыть панель →
  3. 3

    Получите API-ключ

    Перейдите в «Панель → API» и создайте ключ. Полностью он показывается только один раз — скопируйте и сохраните его. При обновлении старый ключ сразу перестаёт работать.

    Получить ключ →
  4. 4

    Подключите и протестируйте

    Отправляйте POST-запросы на адрес ниже с ключом и параметром action. Начните с action=services, чтобы получить ID услуг и цены, затем сделайте небольшой тестовый заказ.

    Адрес API →

API Endpoint

https://smmfoxi.com/api/v2

Все запросы должны отправляться на этот endpoint методом POST или GET.

Аутентификация

Все запросы к API требуют аутентификации с помощью API-ключа. Создайте его в разделе «Панель → API» (полный ключ показывается только один раз — сразу сохраните его). Передавайте параметр key в каждом запросе.

POST https://smmfoxi.com/api/v2
Content-Type: application/json

{
  "key": "YOUR_API_KEY",
  "action": "services"
}

Формат ответа

Все ответы возвращаются в формате JSON. Успешные запросы возвращают запрошенные данные, а ошибки возвращают объект с описанием ошибки.

API Endpoints

Получить сервисы

Возвращает список всех доступных сервисов с их деталями, включая цены, минимальные и максимальные количества.

Параметры

  • key - Ваш API ключ (обязательно)
  • action - "services"
// Пример ответа
[
  {
    "service": 1,
    "name": "Instagram Followers",
    "type": "Default",
    "category": "Instagram",
    "rate": "0.90",
    "min": "100",
    "max": "10000",
    "refill": true,
    "cancel": true
  }
]

Получить баланс

Возвращает текущий баланс вашего аккаунта и валюту.

Параметры

  • key - Ваш API ключ (обязательно)
  • action - "balance"
// Пример ответа
{
  "balance": "100.84292",
  "currency": "USD"
}

Создать заказ

Создает новый заказ для сервиса. Требуемые параметры зависят от типа сервиса.

Стандартный тип

  • key - Ваш API ключ (обязательно)
  • action - "add"
  • service - ID сервиса (обязательно)
  • link - Целевой URL (обязательно)
  • quantity - Количество заказа (обязательно)

Пакетный тип

  • key - Ваш API ключ (обязательно)
  • action - "add"
  • service - ID сервиса (обязательно)
  • link - Целевой URL (обязательно)

Пользовательские комментарии

  • key - Ваш API ключ (обязательно)
  • action - "add"
  • service - ID сервиса (обязательно)
  • link - Целевой URL (обязательно)
  • comments - Комментарии, разделенные переносом строки (обязательно)
// Пример ответа
{
  "order": 23501
}

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

Получить статус одного или нескольких заказов. Можно запросить один заказ или несколько сразу.

Один заказ

  • key - Ваш API ключ (обязательно)
  • action - "status"
  • order - ID заказа (обязательно)

Несколько заказов (до 100)

  • key - Ваш API ключ (обязательно)
  • action - "status"
  • orders - ID заказов, разделенные запятой (обязательно)
// Пример ответа
{
  "charge": "0.27819",
  "start_count": "3572",
  "status": "Completed",
  "remains": "0",
  "currency": "USD"
}

Создать дозаказ

Запросить дозаказ для заказа. Доступно только для сервисов, поддерживающих дозаказы.

Параметры

  • key - Ваш API ключ (обязательно)
  • action - "refill"
  • order - ID заказа (обязательно)
// Пример ответа
{
  "refill": "1"
}

Статус дозаказа

Проверить статус запроса на дозаказ.

Параметры

  • key - Ваш API ключ (обязательно)
  • action - "refill_status"
  • refill - ID дозаказа (обязательно)
// Пример ответа
{
  "status": "Completed"
}

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

  • Pending - Заказ ожидает обработки
  • Processing - Заказ подготавливается
  • In progress - Заказ выполняется
  • Completed - Заказ успешно выполнен
  • Partial - Заказ частично выполнен (возврат за остаток)
  • Canceled - Заказ отменен

Обработка ошибок

При возникновении ошибки API возвращает JSON объект с полем error, описывающим проблему.

// Пример ответа с ошибкой
{
  "error": "Invalid API key"
}

Лимиты запросов

Для обеспечения качества сервиса действуют следующие лимиты:

  • 5 запросов в секунду
  • 100 запросов в минуту
  • 1000 запросов в час