# Додавання проксі-сервера

Створює конфігурацію проксі в команді.
- **Передумови**: `proxyPort` обов'язковий і має бути в діапазоні 1–65535, а `proxyProvider` має бути розпізнаваним Сервісом.
- **Ефект**: вставляє запис проксі й повертає його ідентифікатор, готовий для прив'язки до профілів. Зберігається лише конфігурація.
- **Завершення**: синхронне.
- **Повтор**: **перевірки унікальності назви або конфігурації немає.** Надсилання того самого тіла двічі створить два проксі з двома ідентифікаторами. Після таймауту спершу пошукайте запис у `/proxyInfo/page`, а вже потім вирішуйте, чи надсилати повторно.

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

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

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `city` (string)
    Місто

  - `country` (string)
    Код країни (ISO 3166-1 alpha-2). Обов'язковий лише якщо proxyProvider=17.
    Example: AD

  - `encryptionType` (integer)
    Тип шифрування; допустимі значення — цілі числа від 1 до 14.
    Example: 14

  - `ipChangeAction` (integer)
    Дія при зміні IP: 0 = блокувати, 1 = попередити
    Example: 1

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

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

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

  - `proxyName` (string)
    Назва проксі (підтримує підстановки на кшталт {{random}})
    Example: sock5_{{random}}

  - `proxyPort` (integer, required)
    Номер порту проксі
    Example: 65534

  - `proxyProvider` (integer, required)
    Тип сервісу проксі:
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.
Особливі правила:
- Якщо proxyProvider дорівнює 7 або 8, поле proxyType обов'язкове.
- Якщо proxyProvider дорівнює 17, поле country обов'язкове; state і city необов'язкові.
    Example: 2

  - `proxyType` (integer)
    Тип протоколу проксі: 0=HTTP, 1=HTTPS, 2=SOCKS5, 3=SSH.
Обов'язково лише коли proxyProvider дорівнює 7 або 8.
    Example: 1

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

  - `state` (string)
    Область/штат

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

## Response 200:

  - `200` (unknown)
    Успіх. `data` — одне значення типу integer.

## Response 200 fields (application/json):

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

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

  - `data` (integer, required)
    Ідентифікатор проксі

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