# KILLA PROXY & VPN

> Один API для VPN-подписок, серверных и резидентных прокси: узнать цену, купить, продлить и управлять — из своего бота или панели.

HTTP API, версия `v1`. Базовый адрес: `https://proxy.killa.cc/api/v1`.
Токен — в заголовке `Authorization: Bearer <token>`, тело и ответы — JSON.
Успех — `{"ok": true, "data": { ... }}`, ошибка — `{"ok": false, "error": {"code": "...", "message": "...", "details": null}}`. Полезные поля лежат внутри `data`.
Поле `details` в ответе есть всегда: `null`, когда уточнять нечего.

## Начни отсюда

- [Полная документация одним файлом](https://proxy-docs.killa.cc/llms-full.txt): все методы, параметры, примеры запросов и ответов, ошибки, сценарии и правила. Одного этого файла достаточно, чтобы написать интеграцию.
- [Описание OpenAPI 3.1](https://proxy-docs.killa.cc/openapi.json): для генераторов клиентов, Postman и Insomnia.
- [Справочник в исходном виде](https://proxy-docs.killa.cc/content/api.json): те же методы структурой JSON.

## Страницы документации

- [Главная](https://proxy-docs.killa.cc/)
- [Сценарии](https://proxy-docs.killa.cc/scenarios)
- [Все методы](https://proxy-docs.killa.cc/methods)
- [VPN](https://proxy-docs.killa.cc/methods/vpn): Подписки и устройства клиентов
- [Серверные прокси](https://proxy-docs.killa.cc/methods/dedicated): Выделенные и общие IPv4, IPv6
- [Резидентные прокси](https://proxy-docs.killa.cc/methods/residential): Трафик, локации, прокси-листы
- [Аккаунт](https://proxy-docs.killa.cc/methods/internal): Баланс и расходы
- [Ошибки](https://proxy-docs.killa.cc/errors)
- [Правила работы](https://proxy-docs.killa.cc/rules)
- [Что нового](https://proxy-docs.killa.cc/changelog)
- [Поддержка](https://proxy-docs.killa.cc/support)

## Методы

- `GET /vpn/quote` — Цены на VPN: Возвращает цены на месячные тарифы и условия платного пробного тарифа.
- `POST /vpn/buy` — Купить подписку: Создаёт новую подписку и списывает её цену с баланса.
- `GET /vpn/info` — Информация о подписке: Показывает статус, срок, ссылку, лимит трафика и лимит устройств подписки.
- `POST /vpn/renew` — Продлить подписку: Продлевает подписку на выбранный период и списывает его цену с баланса.
- `GET /vpn/hwid/devices` — Список устройств: Показывает подключённые устройства и лимит подписки.
- `POST /vpn/hwid/reset` — Сбросить одно устройство: Отвязывает одно устройство от подписки и освобождает место под новое.
- `POST /vpn/hwid/reset-all` — Сбросить все устройства: Отвязывает от подписки все устройства сразу.
- `GET /vpn/hwid/quote` — Цены на увеличение лимита: Возвращает, на сколько устройств можно увеличить лимит и сколько это стоит.
- `POST /vpn/hwid/increase` — Увеличить лимит устройств: Увеличивает лимит устройств подписки и списывает цену с баланса.
- `POST /vpn/delete` — Удалить подписку: Удаляет подписку.
- `GET /dedicated/quote` — Посчитать стоимость: Считает цену покупки: за всё количество и за одну прокси.
- `GET /dedicated/country` — Список стран: Возвращает страны, в которых можно купить прокси выбранного типа.
- `GET /dedicated/count` — Сколько прокси доступно: Показывает, сколько прокси выбранного типа есть в стране прямо сейчас.
- `POST /dedicated/buy` — Купить прокси: Покупает прокси и списывает их цену с баланса.
- `GET /dedicated/prolong/quote` — Стоимость продления: Считает цену продления для списка прокси: общую и по каждой.
- `POST /dedicated/prolong` — Продлить прокси: Продлевает прокси на выбранный срок и списывает цену с баланса.
- `GET /residential/traffic/quote` — Посчитать стоимость трафика: Считает цену трафика с учётом скидки.
- `POST /residential/traffic/buy` — Купить трафик: Создаёт подписку клиента на пул и начисляет трафик.
- `POST /residential/traffic/add` — Пополнить трафик: Начисляет клиенту дополнительный трафик и списывает цену с баланса.
- `GET /residential/traffic/balance` — Остаток трафика: Показывает, сколько трафика осталось у клиента.
- `POST /residential/locations/{level}` — Локации: Возвращает доступные страны, регионы, города, почтовые индексы или провайдеров (ASN) — для фильтров прокси-листа.
- `POST /residential/proxies/generate` — Сгенерировать прокси-лист: Собирает прокси-лист клиента: адреса через домен и через IP в выбранном формате.
- `POST /residential/proxies/rotate-ip` — Сменить IP: Меняет IP у sticky-сессий клиента.
- `GET /residential/whitelist` — Разрешённые IP: Показывает IP-адреса, с которых клиент подключается к прокси без логина и пароля.
- `POST /residential/whitelist/add` — Добавить IP: Разрешает подключаться к прокси с этого IP без логина и пароля.
- `POST /residential/whitelist/remove` — Убрать IP: Запрещает подключение без пароля с этого IP.
- `GET /residential/password` — Текущий пароль: Возвращает логин и текущий пароль клиента для прокси.
- `POST /residential/password/reset` — Сбросить пароль: Выдаёт клиенту новый пароль для прокси.
- `GET /balance` — Баланс: Показывает, сколько денег на балансе и сколько всего потрачено через API.

## Контакты

- Поддержка: https://t.me/KillaSupport_Bot
- Сотрудничество: https://t.me/KillaCreator

Документация обновлена: 2026-11-03.