История прокси

Получите список заказанных прокси и управляйте их настройками.

Получить историю прокси

Получите все заказанные вами прокси.

Endpoint

GET /proxies/history/

Параметры запроса

Параметр	Тип	Обязательно	Описание
page	integer	Нет	Номер страницы для пагинации
page_size	integer	Нет	Количество результатов на странице

Запрос

curl -X 'GET' \
  'https://app.cyberyozh.com/api/v1/proxies/history/' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: ваш_api_ключ'

Ответ

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "9a440c2a-157f-4562-8209-25022ec4143a",
      "url": "socks5://0.0.0.0:10000",
      "connection_login": "логин_подключения",
      "connection_password": "пароль_подключения",
      "system_status": "active",
      "expired": false,
      "access_starts_at": "2023-08-25T11:25:31.218478Z",
      "access_expires_at": "2023-08-26T11:25:28.742274Z",
      "public_ipaddress": "1.1.1.1",
      "geoip": "United States",
      "traffic_remains": -1,
      "change_ip_links": [],
      "ovpn_config_link": "---",
      "auto_renew_request": false,
      "proxy_category": "lte",
      "access_type": "private",
      "connection_host": "0.0.0.0",
      "connection_port": "10000",
      "xray_settings_str": null
    }
  ]
}

Поля ответа

Поле	Тип	Описание
count	integer	Общее количество результатов
next	string	URL следующей страницы (null если последняя)
previous	string	URL предыдущей страницы (null если первая)
results	array	Массив записей истории прокси
id	string (UUID)	Уникальный идентификатор прокси
url	string	URL подключения к прокси
connection_login	string	Логин для подключения
connection_password	string	Пароль для подключения
connection_host	string	Хост прокси-сервера
connection_port	string	Порт прокси-сервера
system_status	string	Текущий статус (active, inactive)
expired	boolean	Истек ли срок действия прокси
access_starts_at	string (datetime)	Время начала доступа
access_expires_at	string (datetime)	Время истечения
public_ipaddress	string	Публичный IP-адрес
geoip	string	Географическое расположение
traffic_remains	integer	Остаток трафика в байтах (-1 для безлимитного)
change_ip_links	array	Ссылки для смены IP
ovpn_config_link	string	Ссылка на конфигурацию OpenVPN
auto_renew_request	boolean	Статус автопродления
proxy_category	string	Категория: datacenter, lte, residential_rotating, residential_static
access_type	string	Тип доступа: shared или private
xray_settings_str	string	Настройки Xray прокси (null если неприменимо)

Обновить автопродление

Изменить настройку автопродления для прокси.

Endpoint

PATCH /proxies/history/{id}/

Параметры пути

Параметр	Тип	Обязательно	Описание
id	string (UUID)	Да	Идентификатор записи истории прокси

Запрос

curl -X 'PATCH' \
  'https://app.cyberyozh.com/api/v1/proxies/history/9a440c2a-157f-4562-8209-25022ec4143a/' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: ваш_api_ключ' \
  -H 'Content-Type: application/json' \
  -d '{
    "auto_renew_request": true
  }'

Тело запроса

Поле	Тип	Обязательно	Описание
auto_renew_request	boolean	Нет	Включить или отключить автопродление

Ответ

Возвращает полный объект истории прокси (см. поля ответа выше).

Смена отпечатка

Изменить отпечаток браузера для указанного прокси-сервера.

Endpoint

POST /proxies/history/{id}/change-fingerprint/

Параметры пути

Параметр	Тип	Обязательно	Описание
id	string (UUID)	Да	Идентификатор записи истории прокси

Запрос

curl -X 'POST' \
  'https://app.cyberyozh.com/api/v1/proxies/history/9a440c2a-157f-4562-8209-25022ec4143a/change-fingerprint/' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: ваш_api_ключ' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": "windows:4"
  }'

Тело запроса

Поле	Тип	Обязательно	Описание
value	string	Да	Идентификатор отпечатка (см. значения ниже)

Значения отпечатков

Значение	Описание
android:4	Android 14
macosx:4	MacOSX 12.6
ios:3	iPhone 12 Max
windows:1	Windows 10 Server
windows:4	Windows 10 Desktop
""	Сбросить отпечаток

Ответ

{
  "status": "success",
  "message": "Fingerprint updated successfully",
  "code": "FINGERPRINT_UPDATED"
}