Эндпоинты профиля и трекера

Просмотр данных аккаунта, ротация API-ключа, настройка глобальных шаблонов постбэков, выбор языка интерфейса и подключение трекера.

Данные профиля

GET /api/profile/info.json

Возвращает текущие данные аккаунта, тариф, использование и пять глобальных шаблонов URL постбэков.

{
  "status": "ok",
  "data": {
    "id": 42,
    "name": "John Doe",
    "login": "johndoe",
    "lang": "en",
    "tariff": "cat",
    "tariff_name": "Kitty",
    "tariff_campaigns": 15,
    "paid_until": "2026-07-01 00:00:00",
    "campaigns": 3,
    "pb_wait": "",
    "pb_hold": "",
    "pb_approve": "https://track.example.com/postbacks/abc?click={click}&status=approve",
    "pb_cancel": "https://track.example.com/postbacks/abc?click={click}&status=cancel",
    "pb_trash": "https://track.example.com/postbacks/abc?click={click}&status=trash",
    "notify": {
      "tariff": true,
      "leads": true
    }
  }
}

tariff_campaigns равен -1 для тарифа Tiger (безлимитный). paid_until равен "0000-00-00 00:00:00" для аккаунтов, которые никогда не платили. campaigns — количество неудалённых кампаний. Пустые поля pb_* означают, что постбэк для этого события глобально отключён. notify.tariff — включены ли предупреждения об окончании тарифа (по умолчанию true). notify.leads — глобальный переключатель уведомлений о лидах (по умолчанию true). О принципе «глобальные vs. кампания» — в разделе Интеграция с трекером.

Сброс API-ключа

POST /api/profile/apikey.json

Генерирует новый API-ключ. Старый ключ перестаёт работать немедленно.

{ "status": "ok", "data": { "key": "42-new_key_value…" } }

Настройка глобальных постбэков

POST /api/profile/postbacks.json

Устанавливает пять глобальных шаблонов URL постбэков. Частичное обновление — записываются только переданные поля; пропущенное поле не изменяется. Передайте пустую строку, чтобы очистить шаблон.

Параметр	Описание
`pb_wait`	Шаблон URL для события wait (открыта ссылка бота)
`pb_hold`	Шаблон URL для события hold (отправлена заявка на вступление)
`pb_approve`	Шаблон URL для события approve (вступил или заявка одобрена)
`pb_cancel`	Шаблон URL для события cancel (покинул чат добровольно, в пределах окна)
`pb_trash`	Шаблон URL для события trash (кик или бан, в пределах окна)

Доступные {макросы} в шаблонах — в разделе Интеграция с трекером → Макросы.

{ "status": "ok" }

Настройка уведомлений

POST /api/profile/notify.json

Устанавливает настройки уведомлений. Частичное обновление — пропущенные поля не изменяются.

Параметр	Тип	Описание
`tariff`	bool	`true` = получать предупреждения об окончании тарифа (по умолчанию). Уведомление об оплате отправляется всегда.
`leads`	bool	`true` = глобальный переключатель уведомлений о лидах из всех кампаний (по умолчанию).

{ "status": "ok" }

Выбор языка

POST /api/profile/lang.json

Параметр	Описание
`lang`	`en` или `ru`

{ "status": "ok" }

Проверка текущей сессии

GET /api/profile/login.json

Возвращает пользователя для текущего сессионного токена. Требует сессионный токен (не API-ключ) — дашборд использует это для проверки актуальности сессии.

{ "status": "ok", "data": { "id": 42, "name": "John Doe" } }

Авторизация через Telegram

GET /api/auth/poll.json — без авторизации

Именно так дашборд получает сессию после входа через Telegram. При скриптовой работе с API-ключом этот эндпоинт не нужен.

Схема: дашборд генерирует случайный nonce и показывает пользователю диплинк на сервисного бота (@altercpatopbot?start=login-{nonce}). Затем он опрашивает этот эндпоинт до тех пор, пока пользователь не откроет ссылку.

Параметр	Описание
`nonce`	Случайный nonce, сгенерированный клиентом

Пока пользователь не открыл ссылку:

{ "status": "ok", "pending": true }

После того как пользователь открыл ссылку:

{ "status": "ok", "pending": false, "token": "sess_token_value…" }

Nonce одноразовый — он удаляется в момент погашения.

Статус интеграции с трекером

GET /api/profile/tracker.json

Возвращает статус подключения трекера. API-ключ никогда не возвращается.

{ "status": "ok", "data": { "connected": true, "domain": "www.altercpa.red" } }

Подключение / отключение трекера AlterCPA Lite

POST /api/profile/tracker.json

Подключение: передайте domain + key. Проверяет учётные данные через запрос GET /api/tracker/status.json на домен трекера, затем автоматически заполняет все пять глобальных шаблонов постбэков. Полная инструкция — в разделе Интеграция с AlterCPA Lite.

Параметр	Описание
`domain`	Домен трекера, например `www.altercpa.red`. Пустая строка — для отключения.
`key`	Ваш API-ключ трекера (формат `{user_id}-{user_api}` на стороне трекера). Обязателен при подключении.

{ "status": "ok", "data": { "connected": true, "domain": "www.altercpa.red" } }

Ошибка	Значение
`connect`	Домен трекера недоступен или вернул ошибку

Отключение: передайте domain="". Очищает домен и ключ трекера. Шаблоны постбэков сохраняются — они продолжают отправляться до тех пор, пока вы не отредактируете или не очистите их вручную.

Авторизация и соглашения Боты