API

API-ключи и права

API-ключ работает с аккаунтом из программы или ИИ-клиента в пределах выданных ему прав. Ключ не может менять пароль и почту, удалять аккаунт и создавать другие ключи.

Обновлено 22 ноября 2026

Создание ключа#

  1. Откройте API-ключи в личном кабинете

    API-ключи, затем Создать ключ.

  2. Укажите название и права

    Если ключ может покупать, задайте дневной лимит. При необходимости укажите срок действия и список разрешённых IP.

  3. Подтвердите паролем аккаунта

    Аккаунты, которые входят через Google, подтверждают создание 6-значным кодом из письма на почту аккаунта. Код действует 10 минут.

  4. Скопируйте ключ

    Ключ показывается один раз. 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 активных ключей.

Не нашли ответ?

Поддержка отвечает в чате на сайте круглосуточно. Быстрее всего обычно отвечают в Телеграм, а на тикет ответ придёт на почту.