# Добавление прокси

Создаёт конфигурацию прокси в команде.
- **Предварительные условия**: `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)
    Идентификатор запроса операции