API

Управление прокси через API

Пароль прокси, белый список IP, отпечаток ОС, генерация резидентских прокси и мобильные устройства через API, с правом, которое нужно каждому действию.

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

Новый пароль прокси#

POST /orders/{id}/change-password выдаёт новый пароль всем прокси заказа. Старый пароль перестаёт работать. Нужно право manage. В ответе возвращается заказ: новый пароль виден только ключу, у которого есть и право credentials.

Shell
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.

Shell
# 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. Подмена не работает, пока в белом списке есть адреса, подробнее на странице Отпечаток ОС.

Shell
# 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/statusreadОстаток и расход трафика в ГБ. ?tier=pro для Residential Pro.
POST /residential/generatecredentialsСтроки прокси из остатка трафика. Генерация не списывает деньги, трафик учитывается при использовании прокси.
GET /residential/portsreadПорты HTTP, SOCKS5 и общие порты тарифа.
GET /residential/entry-hostsreadТочки входа тарифа.
GET /residential/usagereadТрафик по дням и сайтам. days от 1 до 90.
Shell
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 строк
countryany или код страны, например us
cityНеобязательно, город
sessionrotating или sticky
ttlВремя жизни фиксированной сессии, от 1 до 10080 минут
protocolhttp или socks5
tierpro для Residential Pro, для стандартного тарифа не указывается

Строки выдаются в том же формате, что в генераторе личного кабинета, он описан на странице Генератор.

Мобильные устройства#

Shell
# 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-historyreadoffset, count до 100
POST /mobile/orders/{id}/rotate-ipmanageБез тела. Действует минимальный интервал устройства
POST /mobile/orders/{id}/rotationmanageminutes от 0 до 1440. При 0 IP меняется только по запросу
POST /mobile/orders/{id}/osmanagefamily: windows, android, ios, macos или пустая строка для отключения
POST /mobile/orders/{id}/ip-modemanagemode: v4 или v6
POST /mobile/orders/{id}/authcredentialsmode: credentials или ip, и ips, до 10 адресов
GET /mobile/orders/{id}/openvpncredentialsФайл конфигурации OpenVPN
GET /mobile/orders/{id}/wireguardcredentialsФайл конфигурации WireGuard

Без права credentials состояние устройства возвращается без логина и ссылки VLESS.

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

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