API
API Proxya
API Proxya позволяет программам и ИИ-клиентам работать с аккаунтом: читать баланс и заказы, покупать и продлевать прокси, получать данные для подключения и менять настройки прокси в пределах прав API-ключа.
Обновлено 22 ноября 2026
Возможности API#
- Чтение баланса, заказов, цен, наличия и резидентского трафика.
- Покупка новых заказов и продление существующих с баланса в пределах дневного лимита ключа.
- Логины, пароли и ссылки прокси, генерация резидентских прокси.
- Настройки прокси: пароль, белый список IP, отпечаток ОС, смена IP мобильных.
Тот же API доступен ИИ-клиентам через MCP-сервер.
Базовый адрес и формат#
Все адреса в разделе указаны относительно https://proxya.co/api/v1. Запросы и ответы передаются в JSON. API-ключ передаётся в заголовке Authorization.
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 содержит список полей с причиной для каждого.
{"detail": "This API key doesn't have the purchase permission"}| Статус | Значение |
|---|---|
| 400 | Запрос отклонён правилом: исчерпан дневной лимит, у покупки нет Idempotency-Key, цена отличается от текущей. |
| 401 | Ключа нет, либо он неизвестен, отозван или истёк. |
| 402 | Недостаточно средств на балансе. |
| 403 | У ключа нет нужного права, маршрут не принимает ключи, адрес не входит в список IP ключа или аккаунт заблокирован. |
| 404 | Заказ не существует или принадлежит другому аккаунту. |
| 409 | Idempotency-Key уже использован для другого запроса или первый запрос с ним ещё выполняется. |
| 422 | Поле отсутствует или имеет неверное значение. |
| 429 | Слишком много запросов. Заголовок Retry-After содержит число секунд ожидания. |
| 502, 503 | Поставщик или сервис временно недоступен. Перед повтором покупки проверьте список заказов. |
Ограничения частоты#
- 120 запросов в минуту на ключ по всем маршрутам вместе.
- 10 покупок, продлений или восстановлений в минуту с одного адреса.
- У части действий свой предел, например новый IP мобильного не чаще 12 раз в минуту.
Страницы раздела#
Не нашли ответ?
Поддержка отвечает в чате на сайте круглосуточно. Быстрее всего обычно отвечают в Телеграм, а на тикет ответ придёт на почту.