Регистрация

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

API документация для интеграции

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

Для работы с API необходимо использовать API ключ, который можно получить в личном кабинете. API ключ передается в параметрах запроса в формате key=YOUR_API_KEY. 

// Пример параметра авторизации
key=YOUR_API_KEY

Важно: Храните ваш API ключ в безопасном месте и не передавайте его третьим лицам.

Базовый URL

Все API запросы должны отправляться на следующий базовый URL:

https://smmrails.com/api/v2

Метод: POST

Content-Type: application/x-www-form-urlencoded

Получение списка услуг

POST /api/v2
Возвращает список всех доступных услуг с их параметрами и ценами.

Параметры запроса:

Параметр Тип Обязательный Описание
key string Да Ваш API ключ
action string Да Действие: "services" 
POST /api/v2
// Параметры запроса
key=YOUR_API_KEY&action=services

Пример успешного ответа:

[
  {
    "service": "1",
    "name": "Instagram Followers [Real]",
    "type": "Default",
    "category": "Instagram - Followers",
    "rate": "0.90",
    "min": "10",
    "max": "10000",
    "refill": true,
    "cancel": true
  },
  {
    "service": "2",
    "name": "Instagram Likes [Fast]",
    "type": "Default",
    "category": "Instagram - Likes",
    "rate": "0.03",
    "min": "50",
    "max": "50000",
    "refill": false,
    "cancel": false
  }
]

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

POST /api/v2
Создает новый заказ на услугу продвижения.

Параметры запроса:

Параметр Тип Обязательный Описание
key string Да Ваш API ключ
action string Да Действие: "add"
service integer Да ID услуги из списка услуг
link string Да Ссылка на аккаунт/пост для продвижения
quantity integer Да Количество единиц для заказа
comments string Нет Комментарии (для Custom Comments услуг) 
POST /api/v2
// Параметры запроса
key=YOUR_API_KEY&action=add&service=1&link=https://instagram.com/username&quantity=1000

Пример успешного ответа:

{
  "order": 12345
}

Примеры ошибок:

{"error": "Not enough funds"}
{"error": "Incorrect link"}
{"error": "Quantity below minimum"}
{"error": "Service not found"}

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

POST /api/v2
Получает информацию о статусе заказа.

Параметры запроса:

Параметр Тип Обязательный Описание
key string Да Ваш API ключ
action string Да Действие: "status"
order integer Да ID заказа 
POST /api/v2
// Параметры запроса
key=YOUR_API_KEY&action=status&order=12345

Пример успешного ответа:

{
  "charge": "0.90",
  "start_count": "100",
  "status": "Completed",
  "remains": "0"
}

Баланс

POST /api/v2
Получает текущий баланс аккаунта.

Параметры запроса:

Параметр Тип Обязательный Описание
key string Да Ваш API ключ
action string Да Действие: "balance" 
POST /api/v2
// Параметры запроса
key=YOUR_API_KEY&action=balance

Пример успешного ответа:

{
  "balance": "1250.50"
}

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

Возможные статусы заказов:

Статус Описание
Pending Заказ ожидает обработки
In progress Заказ в процессе выполнения
Completed Заказ полностью выполнен
Partial Заказ выполнен частично
Processing Заказ обрабатывается
In progress Заказ в процессе выполнения
Canceled Заказ отменен
Awaiting Заказ ожидает
Fail Заказ не удался

Типы услуг

Возможные типы услуг:

Тип Описание
Default Обычная услуга
Custom Comments Услуга с пользовательскими комментариями
Mentions with Hashtags Упоминания с хештегами
Mentions Custom List Упоминания из пользовательского списка
Mentions with Hashtags Упоминания с хештегами
Mentions User Followers Упоминания подписчиков пользователя
Mentions Media Likers Упоминания лайкнувших медиа
Package Пакетная услуга

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

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

  • 60-120 запросов в минуту для всех эндпоинтов

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

Дополнительная информация

  • Период пополнения: 30 дней с момента создания заказа
  • Условия отмены: Только для заказов со статусом "Pending" или "In progress"
  • Частичные заказы: При частичном выполнении возвращаются средства за невыполненную часть
  • Регистр статусов: Статусы чувствительны к регистру
Вернуться на главную