API личного кабинета — инструкция

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

Базовый URL: https://ВАШ-ДОМЕН/cabinet/v1/
Токен лежит в кабинете → блок «API-токен». Администратор может выключить или включить токен в админке.

1. Авторизация

Передавайте токен в каждом запросе одним из способов:

Заголовок Authorization: Bearer pf_… (рекомендуется)
Заголовок X-Api-Token: pf_…
GET-параметр ?token=pf_…

curl -H "Authorization: Bearer ВАШ_ТОКЕН" \
  https://ВАШ-ДОМЕН/cabinet/v1/account.php

Если токен выключен администратором, API отвечает 403 с текстом «API-токен отключён».

2. Методы

GET/cabinet/v1/account.php

Профиль и баланс текущего пользователя по токену.

{
  "ok": true,
  "user": {
    "id": 15,
    "email": "user@mail.ru",
    "name": "Иван",
    "phone": "+7…",
    "balance": 1000.00
  }
}

GET/cabinet/v1/balance.php

Только баланс.

{ "ok": true, "balance": 1000.00, "currency": "RUB" }

GET/cabinet/v1/services.php

Список услуг и цены (ключи service для создания заказа).

GET/cabinet/v1/orders.php

Список заказов (кампаний) с статистикой. Параметр refresh=0 — без запроса статусов у провайдера.

{
  "ok": true,
  "total": 2,
  "orders": [
    {
      "id": 2671,
      "campaign_id": 3289857,
      "service_name": "Авито: …",
      "url": "www.avito.ru/…",
      "quantity": 35,
      "price_total": 120.5,
      "status": "active",
      "actions_all": 0,
      "actions_today": 0,
      "balance_actions": 35,
      "created_at": "2026-07-25 …"
    }
  ]
}

GET/cabinet/v1/order.php?id=2671

Один заказ по локальному id из списка.

POST/cabinet/v1/order.php

Создать заказ. Списание с баланса аккаунта владельца токена.

Поле	Тип	Описание
`service`	string	Ключ услуги из `services.php`
`url`	string	Ссылка на объявление / страницу
`quantity`	int	Количество действий (по умолчанию нужно ≥ 1)
`period`	string	`day` \| `week` \| `month`
`spreading`	string	`normal` \| `equal` \| `8_19` \| `9_21`
`premium_mode`	bool	Премиум режим
`keyword`	string	Если услуга требует ключевой запрос
`instruction`	string	Инструкция (если нужна услуге)
`comment_text`	string	Текст комментария / вопроса
`tab_id`	int	Вкладка в кабинете (опционально)

curl -X POST https://ВАШ-ДОМЕН/cabinet/v1/order.php \
  -H "Authorization: Bearer ВАШ_ТОКЕН" \
  -H "Content-Type: application/json" \
  -d '{
    "service": "avito_favorite",
    "url": "https://www.avito.ru/…",
    "quantity": 100,
    "period": "day",
    "spreading": "normal"
  }'

POST/cabinet/v1/order-action.php

Управление заказом: запуск, остановка, пополнение действий.

{
  "order_id": 2671,
  "action": "start"
}

{
  "order_id": 2671,
  "action": "stop"
}

{
  "order_id": 2671,
  "action": "topup",
  "actions": 500
}

3. Коды ответов

HTTP	Значение
200	Успех (`ok: true`)
400	Ошибка параметров
401	Нет / неверный токен
403	Токен выключен
402	Недостаточно средств
404	Заказ не найден
502 / 503	Ошибка внешнего сервиса

4. Где взять токен

Зарегистрируйтесь или войдите в личный кабинет.
Откройте блок «API-токен».
Скопируйте токен или перевыпустите его.
Изучите ключи услуг через GET /cabinet/v1/services.php.

Администратор в разделе «Пользователи» может включить, выключить или перевыпустить токен любого аккаунта.

5. Пример на PHP

$token = 'pf_…';
$base = 'https://ВАШ-ДОМЕН/cabinet/v1/';

$ch = curl_init($base . 'balance.php');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . $token,
    'Accept: application/json',
  ],
]);
$out = curl_exec($ch);
curl_close($ch);
$data = json_decode($out, true);
print_r($data);

Открыть кабинет На главную