API — Профили, пресеты и роутинг

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

Профили

GET /api/v1/profiles Требуется авторизация

Возвращает список сохранённых идентичностей с опциональной постраничной навигацией и фильтром по браузеру.

Параметр	Тип	Обязательный	Описание
`limit`	`int (query)`	Нет	Размер страницы (по умолчанию 100).
`offset`	`int (query)`	Нет	Смещение страницы (по умолчанию 0).
`browser`	`string (query)`	Нет	Фильтр по браузеру, например "chrome".

Пример (curl)

curl -H "X-API-Key: YOUR_API_KEY" "http://127.0.0.1:8891/api/v1/profiles?browser=chrome&limit=50"

GET /api/v1/counts Требуется авторизация

Возвращает количество идентичностей по каждому семейству браузеров.

Пример (curl)

curl -H "X-API-Key: YOUR_API_KEY" http://127.0.0.1:8891/api/v1/counts

Ответ

{ "Chrome": 10000, "Firefox": 500, "Safari": 300, "Edge": 200 }

Идентичность порта

POST /api/v1/port/{port}/rotate Требуется авторизация

Меняет идентичность порта на другую в пределах его текущих фильтров.

Пример (curl)

curl -H "X-API-Key: YOUR_API_KEY" -X POST http://127.0.0.1:8891/api/v1/port/20134/rotate

GET /api/v1/port/{port}/profile/view Требуется авторизация

Возвращает полную идентичность, которую порт в данный момент представляет.

Пример (curl)

curl -H "X-API-Key: YOUR_API_KEY" http://127.0.0.1:8891/api/v1/port/20134/profile/view

Пресеты

Пресеты сохраняют и повторно применяют конфигурации портов, организованные в папки.

GET /api/v1/presets Требуется авторизация

Возвращает список сохранённых пресетов и папок.

POST /api/v1/presets Требуется авторизация

Сохраняет пресет.

POST /api/v1/presets/load Требуется авторизация

Загружает пресет на порт.

DELETE /api/v1/presets Требуется авторизация

Удаляет пресет.

Правила доменного роутинга

GET /api/v1/domain_rules Требуется авторизация

Возвращает упорядоченный список правил доменного роутинга.

PUT /api/v1/domain_rules Требуется авторизация

Заменяет правила доменного роутинга. Каждое правило сопоставляет домены и направляет их по выбранному маршруту с опциональными переопределениями спуфинга.

Шлюзы (OpenVPN / VLESS)

GET /api/v1/ovpn Требуется авторизация

Возвращает список сохранённых шлюзов и статус их туннелей.

POST /api/v1/ovpn Требуется авторизация

Добавляет шлюз (файл .ovpn или ссылку vless://).

PUT /api/v1/ovpn/{name} Требуется авторизация

Обновляет существующий шлюз.

DELETE /api/v1/ovpn/{name} Требуется авторизация

Удаляет шлюз (отклоняется, если он используется).

GET /api/v1/gateway/openvpn-status Требуется авторизация

Сообщает, доступен ли на хосте бэкенд OpenVPN/VLESS.