API
Управление прокси через API
Пароль прокси, белый список IP, отпечаток ОС, генерация резидентских прокси и мобильные устройства через API, с правом, которое нужно каждому действию.
Обновлено 22 ноября 2026
Новый пароль прокси#
POST /orders/{id}/change-password выдаёт новый пароль всем прокси заказа. Старый пароль перестаёт работать. Нужно право manage. В ответе возвращается заказ: новый пароль виден только ключу, у которого есть и право credentials.
curl -X POST https://proxya.co/api/v1/orders/$ORDER_ID/change-password \
-H "Authorization: Bearer $PROXYA_API_KEY"Белый список IP#
Адреса из белого списка подключаются к ISP и датацентр-прокси без пароля. Добавление адреса требует права credentials, удаление требует manage или credentials. Работа белого списка описана на странице Белый список IP.
# Add an address (credentials permission)
curl -X POST https://proxya.co/api/v1/orders/$ORDER_ID/whitelist \
-H "Authorization: Bearer $PROXYA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"ip": "203.0.113.10"}'
# Remove one address. Without ?ip= every address is removed.
curl -X DELETE "https://proxya.co/api/v1/orders/$ORDER_ID/whitelist?ip=203.0.113.10" \
-H "Authorization: Bearer $PROXYA_API_KEY"Отпечаток ОС#
GET, POST и DELETE /orders/{id}/fingerprint читают, включают и выключают подмену отпечатка ОС на заказах ISP и датацентра. Включение требует права manage. Подмена не работает, пока в белом списке есть адреса, подробнее на странице Отпечаток ОС.
# Profiles that can be set
curl https://proxya.co/api/v1/catalog/spoofing-profiles -H "Authorization: Bearer $PROXYA_API_KEY"
# Turn spoofing on with one of them
curl -X POST https://proxya.co/api/v1/orders/$ORDER_ID/fingerprint \
-H "Authorization: Bearer $PROXYA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"profile": "windows"}'
# Turn it off
curl -X DELETE https://proxya.co/api/v1/orders/$ORDER_ID/fingerprint -H "Authorization: Bearer $PROXYA_API_KEY"Резидентские#
| Запрос | Право | Что возвращает |
|---|---|---|
| GET /residential/status | read | Остаток и расход трафика в ГБ. ?tier=pro для Residential Pro. |
| POST /residential/generate | credentials | Строки прокси из остатка трафика. Генерация не списывает деньги, трафик учитывается при использовании прокси. |
| GET /residential/ports | read | Порты HTTP, SOCKS5 и общие порты тарифа. |
| GET /residential/entry-hosts | read | Точки входа тарифа. |
| GET /residential/usage | read | Трафик по дням и сайтам. days от 1 до 90. |
curl -X POST https://proxya.co/api/v1/residential/generate \
-H "Authorization: Bearer $PROXYA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"count": 10, "country": "us", "session": "sticky", "ttl": 30, "protocol": "http"}'| Поле generate | Значение |
|---|---|
| count | От 1 до 500 строк |
| country | any или код страны, например us |
| city | Необязательно, город |
| session | rotating или sticky |
| ttl | Время жизни фиксированной сессии, от 1 до 10080 минут |
| protocol | http или socks5 |
| tier | pro для Residential Pro, для стандартного тарифа не указывается |
Строки выдаются в том же формате, что в генераторе личного кабинета, он описан на странице Генератор.
Мобильные устройства#
# New IP now
curl -X POST https://proxya.co/api/v1/mobile/orders/$ORDER_ID/rotate-ip \
-H "Authorization: Bearer $PROXYA_API_KEY"
# New IP every 10 minutes (0 turns the timer off)
curl -X POST https://proxya.co/api/v1/mobile/orders/$ORDER_ID/rotation \
-H "Authorization: Bearer $PROXYA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"minutes": 10}'| Запрос | Право | Тело |
|---|---|---|
| GET /mobile/orders/{id} | read | Состояние устройства: IP, порты, трафик, настройки |
| GET /mobile/orders/{id}/ip-history | read | offset, count до 100 |
| POST /mobile/orders/{id}/rotate-ip | manage | Без тела. Действует минимальный интервал устройства |
| POST /mobile/orders/{id}/rotation | manage | minutes от 0 до 1440. При 0 IP меняется только по запросу |
| POST /mobile/orders/{id}/os | manage | family: windows, android, ios, macos или пустая строка для отключения |
| POST /mobile/orders/{id}/ip-mode | manage | mode: v4 или v6 |
| POST /mobile/orders/{id}/auth | credentials | mode: credentials или ip, и ips, до 10 адресов |
| GET /mobile/orders/{id}/openvpn | credentials | Файл конфигурации OpenVPN |
| GET /mobile/orders/{id}/wireguard | credentials | Файл конфигурации WireGuard |
Без права credentials состояние устройства возвращается без логина и ссылки VLESS.
Не нашли ответ?
Поддержка отвечает в чате на сайте круглосуточно. Быстрее всего обычно отвечают в Телеграм, а на тикет ответ придёт на почту.