API
API-ключи и права
API-ключ работает с аккаунтом из программы или ИИ-клиента в пределах выданных ему прав. Ключ не может менять пароль и почту, удалять аккаунт и создавать другие ключи.
Обновлено 22 ноября 2026
Создание ключа#
Откройте API-ключи в личном кабинете
API-ключи, затем Создать ключ.
Укажите название и права
Если ключ может покупать, задайте дневной лимит. При необходимости укажите срок действия и список разрешённых IP.
Подтвердите паролем аккаунта
Аккаунты, которые входят через Google, подтверждают создание 6-значным кодом из письма на почту аккаунта. Код действует 10 минут.
Скопируйте ключ
Ключ показывается один раз. Proxya хранит только его хэш и не может показать ключ повторно.
Ключ начинается с proxya_ и состоит из 53 символов. По префиксу сканеры секретов распознают ключ, случайно опубликованный в коде.
Права#
Ключ получает одно или несколько из четырёх прав. Маршрут, которому нужно право, отсутствующее у ключа, отвечает 403.
| Право | Что открывает |
|---|---|
| read | Баланс, заказы, цены, наличие, резидентский трафик, состояние белого списка и отпечатка. Логины, пароли и ссылки прокси возвращаются пустыми, у заказа стоит credentials_hidden: true. |
| credentials | Всё, что позволяет подключиться к прокси: логины, пароли и ссылки, генерация резидентских прокси, VPN-конфигурации мобильных, добавление адреса в белый список IP и IP-авторизация мобильных. |
| purchase | Новые заказы, продление и восстановление с оплатой с баланса в пределах дневного лимита ключа. |
| manage | Настройки, не дающие доступа: новый пароль прокси (показывается только ключу, у которого есть и credentials), смена IP мобильных, отпечаток ОС, заметки к заказам, удаление адреса из белого списка. |
Дневной лимит#
- У ключа с правом purchase обязателен дневной лимит от 1 до 100 000 USD.
- Лимит считает списания по ключу за любые 24 часа. Возврат средств не восстанавливает лимит.
- Покупка сверх лимита отклоняется со статусом
400, баланс не списывается. - Покупки в личном кабинете не входят в лимит ключей.
Срок действия и разрешённые IP#
- Срок действия: 30, 90, 180 или 365 дней либо без срока. После окончания срока ключ получает
401. - Разрешённые IP: до 20 адресов или подсетей в формате CIDR, IPv4 и IPv6. Запрос с другого адреса получает
403. - Если программа обращается к API через прокси, API видит адрес прокси. Добавьте этот адрес или отправляйте запросы к API без прокси.
Уведомления и журнал запросов#
- При создании ключа аккаунт получает уведомление в кабинете и письмо с названием ключа, правами и адресом, с которого он создан.
- При первом запросе с нового адреса аккаунт получает уведомление в кабинете, не больше 5 в сутки.
- Каждый запрос с ключом записывается в журнал: время, метод, путь, статус и адрес. Журнал открывается в строке ключа в кабинете и хранится 90 дней.
Отзыв ключа#
Кнопка Отозвать в строке ключа отключает его сразу. Запросы, которые уже выполняются, завершаются, новые получают 401.
Все ключи аккаунта отзываются автоматически при смене пароля в кабинете, сбросе пароля по ссылке из письма и сбросе через поддержку. Установка первого пароля у аккаунта, который входит через Google, ключи не отзывает.
Хранение ключа#
- Храните ключ в переменной окружения или хранилище секретов, а не в коде и не в репозитории.
- Выдавайте каждой программе отдельный ключ только с нужными правами.
- Задавайте дневной лимит, который покрывает обычную нагрузку и не больше.
- Если ключ мог попасть к посторонним, отзовите его и создайте новый.
На аккаунте может быть до 10 активных ключей.
Не нашли ответ?
Поддержка отвечает в чате на сайте круглосуточно. Быстрее всего обычно отвечают в Телеграм, а на тикет ответ придёт на почту.