# Зміна інформації проксі-сервера

Оновлює конфігурацію проксі.
- **Передумови**: проксі має існувати в команді. **Динамічні проксі через цей ендпоінт оновити неможливо.** Сервіс має бути розпізнаваним значенням.
- **Ефект**: це повне перезаписування, а не часткове оновлення: пропущені вами поля повертаються до значень за замовчуванням, а не зберігають поточні. Спершу прочитайте проксі й надішліть його назад цілком.
- **Область дії**: прив'язки профілів зберігаються, бо змінюється лише сам запис проксі, але вже запущені браузер або хмарний телефон і далі використовують дані підключення, з якими вони були запущені. Перезапустіть їх, щоб застосувати нові.
- **Завершення**: синхронне. Оптимістичного блокування немає, тому за одночасних оновлень перемагає останній запис.

Задокументовані бізнес-помилки: `14003`, `14023`. Значення кодів див. у [Error Codes](../Getting%20Started/error-codes.md). Будь-яка операція може додатково повернути загальні коди.

Endpoint: POST /proxyInfo/update
Version: 2026-09-05
Security: Authorization

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `id` (string, required)
    Унікальний ID проксі

  - `proxyIp` (string, required)
    IP-адреса проксі-сервера

  - `proxyPort` (integer, required)
    Порт проксі-сервера

  - `proxyName` (string)
    Власна назва проксі

  - `country` (string)
    Країна (наприклад, "US", "CN")

  - `city` (string)
    Назва міста

  - `username` (string)
    Ім'я користувача аутентифікації (якщо потрібне)

  - `password` (string)
    Пароль аутентифікації (якщо потрібен)

  - `proxyType` (integer)
    Тип протоколу проксі:
- `0` = HTTP
- `1` = HTTPS
- `2` = SOCKS5
- `3` = SSH

  - `proxyProvider` (integer, required)
    ID сервісу проксі:
- `0` = HTTP
- `1` = HTTPS
- `2` = SOCKS5
- `3` = SSH
- `4` = Oxylabs
- `5` = Proxys.io
- `6` = GeoSurf
- `7` = Luminati
- `8` = Lumauto
- `9` = Oxylabsauto
- `10` = Trojan
- `11` = Shadowsocks
- `12` = vmess
- `13` = ABCPROXY
- `14` = LunaProxy
- `15` = IPHTML
- `16` = PiaProxy
- `17` = 922S5

  - `encryptionType` (integer)
    Тип шифрування (залежить від Сервіса, зазвичай 0 — без шифрування)

  - `ipMonitor` (boolean)
    Увімкнути відстеження зміни IP

  - `ipChangeAction` (integer)
    Дія при зміні IP:
- `1` = Повідомити / Оновити (звичайне значення)

> Повний перелік варіантів див. у документації системи.

  - `refreshUrl` (string)
    URL для запуску зміни IP (якщо підтримується Сервісом)

  - `state` (string)
    Резервне поле або власний стан (необов'язково)

## Response 200:

  - `200` (unknown)
    Успіх. Операція не повертає полезне навантаження; результат передається через `code`.

## Response 200 fields (application/json):

  - `code` (integer, required)
    Код результату. `0` — успіх; інші коди означають помилку.

  - `msg` (string | null, required)
    Повідомлення про помилку

  - `requestId` (string, required)
    Ідентифікатор запиту операції