# Налаштування проксі хмарного телефону

Прив'язує проксі до одного або кількох хмарних телефонів.
- **Передумови**: укажіть хоча б одне з `ids` або `uniqueIds`. Телефони мають належати вашій команді; увімкненими їм бути **не** обов'язково. Якщо ви вказуєте `proxyId`, він має існувати, інакше виклик відхиляється.
- **Ефект**: якщо `proxyId` не вказано або він дорівнює `0`, повторно використовується наявний проксі з цілком однаковими даними підключення, а **якщо збігів немає, у вашій команді створюється новий запис проксі**. Стан перевірки проксі скидається, а попередній проксі запам'ятовується.
- **Завершення**: синхронне. **Увімкнені телефони отримують новий проксі негайно — перезапуск не потрібен**; вимкнені підхоплять його під час наступного запуску.
- **Повтор**: повторна прив'язка наявного `proxyId` ідемпотентна, але повторення виклику із «сирими» даними підключення може щоразу створювати ще один запис проксі, коли дедуплікація не спрацьовує.

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

Endpoint: POST /api/cloudphone/setProxy
Version: 2026-09-05

## Request fields (application/json):

  - `ids` (array)
    Список ідентифікаторів середовищ хмарних телефонів
    Example: ["1558968155668507"]

  - `uniqueIds` (array)
    Список відображуваних порядкових номерів середовищ хмарних телефонів (використовується для звірки, якщо envIds не передано)
    Example: [1001]

  - `proxy` (object)

  - `proxy.proxyId` (string)
    Ідентифікатор конфігурації проксі (значення більше 0 означає повторне використання наявної конфігурації; порожнє значення або <=0 означає створення/оновлення проксі за наступними докладними параметрами)
    Example: 10002

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

  - `proxy.proxyPort` (integer, required)
    Порт проксі-сервера
    Example: 8080

  - `proxy.proxyName` (string)
    Назва/опис конфігурації проксі
    Example: test_proxy_01

  - `proxy.proxyProvider` (integer, required)
    Тип проксі 0:http, 1:https, 2:socks5
    Example: 2

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

  - `proxy.password` (string)
    Пароль для автентифікації проксі
    Example: pwd123

  - `proxy.refreshUrl` (string)
    URL API для оновлення IP динамічного проксі
    Example: http://api.proxy.com/refresh

  - `proxy.country` (string)
    Код країни розташування проксі (наприклад, CN, US)
    Example: US

  - `proxy.state` (string)
    Область/штат розташування проксі
    Example: California

  - `proxy.city` (string)
    Місто розташування проксі
    Example: Los Angeles

## Response 200:

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

## Response 200 fields (application/json):

  - `code` (integer)
    Код відповіді: 0 = успіх, >0 = помилка

  - `data` (null)

  - `msg` (string | null)
    Повідомлення; заповнюється за code > 0

  - `requestId` (string)
    Унікальний ідентифікатор запиту; вкажіть його при зверненні до підтримки