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

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

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

Endpoint: POST /api/proxyInfo/add
Version: 2026-09-05

## 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, країна обов'язкова; штат та місто необов'язкові.
    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 fields (application/json):

  - `code` (integer, required)
    Код результату повернення 0:Звичайний. Інші коди є винятками.

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

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

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