FoxiGrow
Вернуться на главную

Документация API

Версия API: v2

FoxiGrow предоставляет стандартный API SMM Panel, который позволяет интегрировать наши сервисы в ваши приложения. Эта документация охватывает все доступные конечные точки и их использование.

API Endpoint

https://foxigrow.com/api/v2

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

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

Все API запросы требуют аутентификации с использованием вашего API ключа. Вы можете найти свой API ключ в настройках аккаунта. Включайте параметр key в каждый запрос.

POST https://foxigrow.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 запросов в час

Поддержка

Если у вас есть вопросы по API, обратитесь в нашу службу поддержки:

Telegram: @FoxigrowBD