API

API Proxya

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

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

Возможности API#

  • Чтение баланса, заказов, цен, наличия и резидентского трафика.
  • Покупка новых заказов и продление существующих с баланса в пределах дневного лимита ключа.
  • Логины, пароли и ссылки прокси, генерация резидентских прокси.
  • Настройки прокси: пароль, белый список IP, отпечаток ОС, смена IP мобильных.

Тот же API доступен ИИ-клиентам через MCP-сервер.

Базовый адрес и формат#

Все адреса в разделе указаны относительно https://proxya.co/api/v1. Запросы и ответы передаются в JSON. API-ключ передаётся в заголовке Authorization.

http
Authorization: Bearer proxya_...

Ключ создаётся в личном кабинете в разделе API-ключи. Устройство ключей и прав описано на странице API-ключи и права.

Первый запрос#

Ключ читается из переменной окружения PROXYA_API_KEY. Запрос возвращает данные аккаунта и баланс.

curl https://proxya.co/api/v1/users/me \
  -H "Authorization: Bearer $PROXYA_API_KEY"

Ошибки#

Ошибка возвращается с HTTP-статусом и телом JSON с полем detail. При статусе 422 поле detail содержит список полей с причиной для каждого.

json
{"detail": "This API key doesn't have the purchase permission"}
СтатусЗначение
400Запрос отклонён правилом: исчерпан дневной лимит, у покупки нет Idempotency-Key, цена отличается от текущей.
401Ключа нет, либо он неизвестен, отозван или истёк.
402Недостаточно средств на балансе.
403У ключа нет нужного права, маршрут не принимает ключи, адрес не входит в список IP ключа или аккаунт заблокирован.
404Заказ не существует или принадлежит другому аккаунту.
409Idempotency-Key уже использован для другого запроса или первый запрос с ним ещё выполняется.
422Поле отсутствует или имеет неверное значение.
429Слишком много запросов. Заголовок Retry-After содержит число секунд ожидания.
502, 503Поставщик или сервис временно недоступен. Перед повтором покупки проверьте список заказов.

Ограничения частоты#

  • 120 запросов в минуту на ключ по всем маршрутам вместе.
  • 10 покупок, продлений или восстановлений в минуту с одного адреса.
  • У части действий свой предел, например новый IP мобильного не чаще 12 раз в минуту.

Страницы раздела#

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

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