Изменение информации о прокси-сервере

Справочник API

Изменение информации о прокси-сервере

Request

Обновляет конфигурацию прокси.

Предварительные условия: прокси должен существовать в команде. Динамические прокси через этот эндпоинт обновить нельзя. Сервис должен быть распознаваемым значением.
Эффект: это полная перезапись, а не частичное обновление: опущенные вами поля возвращаются к значениям по умолчанию, а не сохраняют текущие. Сначала прочитайте прокси и отправьте его обратно целиком.
Область действия: привязки профилей сохраняются, потому что меняется только сама запись прокси, но уже запущенные браузер или облачный телефон продолжают использовать данные подключения, с которыми они были запущены. Перезапустите их, чтобы применить новые.
Завершение: синхронное. Оптимистичной блокировки нет, поэтому при одновременных обновлениях побеждает последняя запись.

Задокументированные бизнес-ошибки: 14003, 14023. Значения кодов см. в Error Codes. Любая операция может дополнительно вернуть общие коды.

Security

Authorization

Bodyapplication/jsonrequired

idstringrequired

Уникальный ID прокси

proxyIpstringrequired

IP-адрес прокси-сервера

proxyPortintegerrequired

Порт прокси-сервера

proxyNamestring

Пользовательское название прокси

countrystring

Страна (например, "US", "CN")

citystring

Название города

usernamestring

Имя пользователя аутентификации (если требуется)

passwordstring

Пароль аутентификации (если требуется)

proxyTypeinteger

Тип протокола прокси:

0 = HTTP
1 = HTTPS
2 = SOCKS5
3 = SSH

proxyProviderintegerrequired

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

encryptionTypeinteger

Тип шифрования (зависит от Сервиса, обычно 0 — без шифрования)

ipMonitorboolean

Включить отслеживание смены IP

ipChangeActioninteger

Действие при смене IP:

1 = Уведомить / Обновить (обычное значение)

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

refreshUrlstring

URL для запуска смены IP (если поддерживается Сервисом)

statestring

Резервное поле или пользовательское состояние (необязательно)

curl -i -X POST \
  https://api.morelogin.com/proxyInfo/update \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "1566403036579198",
    "proxyIp": "108.11.23.85",
    "proxyPort": 4096,
    "proxyName": "MyProxy",
    "country": "US",
    "city": "New York",
    "username": "",
    "password": "",
    "proxyType": 0,
    "proxyProvider": 0,
    "encryptionType": 0,
    "ipMonitor": true,
    "ipChangeAction": 1,
    "refreshUrl": "",
    "state": ""
  }'

Responses

Успех. Операция не возвращает полезную нагрузку; результат передаётся через code.

Headers

any

Bodyapplication/json

codeintegerrequired

Код результата. 0 — успех; другие коды означают ошибку.

msgstring or nullrequired

Сообщение об ошибке

requestIdstringrequired

Идентификатор запроса операции

Response

{
  "code": 0,
  "msg": "",
  "requestId": "efgh5678"
}