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

Followir предоставляет простой HTTP API в распространённом формате SMM Panel API v2, поэтому большинство реселлерских панелей и скриптов работают с ним без изменений. Все ответы возвращаются в формате JSON.

Начало работы

Создайте аккаунт и пополните баланс.
Откройте страницу API в своём аккаунте и сгенерируйте API-ключ. Храните его в секрете.
По желанию: добавьте IP-адреса, которым разрешено использовать ваш ключ (оставьте поле пустым, чтобы разрешить любой IP).

Эндпоинт

URL	`https://followir.com/api/v2`
Метод	POST (GET тоже работает)
Формат	Параметры формы на входе, JSON на выходе
Обязательно в каждом вызове	`key` (ваш API-ключ) и `action`

Действия

action	Параметры	Что делает
`services`	key	Список всех доступных услуг с ценами и лимитами
`add`	key, service, link, quantity (runs, interval для drip-feed)	Создать новый заказ
`status`	key, order или orders (через запятую)	Статус заказа — одного или нескольких
`cancel`	key, order или orders (через запятую)	Отмена заказов для услуг, которые это допускают
`refill`	key, order или orders (через запятую)	Запрос восстановления для подходящих заказов
`refill_status`	key, refill	Статус запроса на восстановление
`balance`	key	Ваш текущий баланс и валюта

services

curl -X POST "https://followir.com/api/v2" -d "key=YOUR_API_KEY" -d "action=services"

[
  {
    "service": "1",
    "name": "Instagram Followers",
    "type": "Default",
    "category": "Instagram",
    "rate": "0.9000",
    "min": "100",
    "max": "100000",
    "refill": true,
    "cancel": false
  }
]

rate — цена за 1000. refill и cancel показывают, поддерживает ли услуга восстановление и отмену.

add

curl -X POST "https://followir.com/api/v2" \
  -d "key=YOUR_API_KEY" -d "action=add" \
  -d "service=1" -d "link=https://instagram.com/username" -d "quantity=1000"

{ "order": 850758 }

Для drip-feed услуг можно также передать runs (не менее 2) и interval (минуты, от 1 до 1440). Для остальных услуг они игнорируются.

status

curl -X POST "https://followir.com/api/v2" -d "key=YOUR_API_KEY" -d "action=status" -d "order=850758"

{
  "charge": "0.9000",
  "start_count": "3572",
  "status": "In progress",
  "remains": "400",
  "currency": "USD"
}

Несколько заказов сразу: передайте orders=850758,850759. Ответ — объект, ключами которого служат номера заказов. Возможные значения status: Pending, In progress, Completed, Partial, Canceled, Refunded.

cancel

curl -X POST "https://followir.com/api/v2" -d "key=YOUR_API_KEY" -d "action=cancel" -d "order=850758"

{ "status": "Success" }

Некоторые отмены ожидают подтверждения, и тогда в ответе будет "status": "Pending". При отмене нескольких заказов вы получите список элементов { "order": ..., "cancel": ... }.

refill и refill_status

curl -X POST "https://followir.com/api/v2" -d "key=YOUR_API_KEY" -d "action=refill" -d "order=850758"
{ "refill": "12" }

curl -X POST "https://followir.com/api/v2" -d "key=YOUR_API_KEY" -d "action=refill_status" -d "refill=12"
{ "refill": "12", "status": "Pending" }

balance

curl -X POST "https://followir.com/api/v2" -d "key=YOUR_API_KEY" -d "action=balance"

{ "balance": "25.50", "currency": "USD" }

Ошибки

Если что-то идёт не так, в ответе появляется поле error:

{ "error": "Not enough funds" }

Сообщение	Значение
`API key is required`	Отсутствует параметр `key`
`Action is required` / `Incorrect action`	Параметр `action` отсутствует или неизвестен
`Invalid API key`	Ключ неверный или отключён, либо вашего IP нет в белом списке
`Incorrect service ID` / `Service not found`	Номер услуги не существует или услуга отключена
`Link is required` / `Incorrect quantity`	Ссылка не указана, либо количество не является допустимым числом
`Quantity must be between ...`	Вне минимума и максимума услуги
`Not enough funds`	На вашем балансе недостаточно средств для этого заказа
`Order not found`	Такого заказа нет в вашем аккаунте
`Cancel is not available for this service`	Эту услугу нельзя отменить

Примеры кода

PHP

$ch = curl_init("https://followir.com/api/v2");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'key'    => 'YOUR_API_KEY',
    'action' => 'add',
    'service'  => 1,
    'link'     => 'https://instagram.com/username',
    'quantity' => 1000,
]));
$response = json_decode(curl_exec($ch), true);
print_r($response);

Python

import requests

r = requests.post("https://followir.com/api/v2", data={
    "key": "YOUR_API_KEY",
    "action": "status",
    "order": 850758,
})
print(r.json())

Полезно знать

Номера заказов совпадают с теми, что вы видите на странице заказов.
Одновременное оформление нескольких заказов на одну ссылку может быть отклонено, пока не завершится первый.
Каждый вызов записывается в журнал вашего аккаунта. Если вы думаете, что ключ скомпрометирован, перевыпустите его на странице API.
Нужна помощь с интеграцией? Откройте тикет на странице поддержки.