Справочник API
Прокси
Редактирование прокси

Базовый URL

PUT
https://v1.empr.cloud/api/v1/folders/{folderId}/proxies/{proxyId}

Запрос

Заголовки запроса

Заголовки запроса
Название
Тип / Значение
Описание
X-Token
String
Токен авторизации
Content-Type
application/json

Параметры URL

Параметры запроса
Название
Тип / Значение
Описание
folderId
UUID
ID папки
proxyId
UUID
ID прокси, которую нужно отредактировать

Тело запроса

Смотрите тип Proxy в разделе Типы

Примеры запросов

1const url =
2  "https://v1.empr.cloud/api/v1/folders/{folderId}/proxies/{proxyId}"; 
3
4const body = {
5  "proxy_name": "Proxy",
6  "proxy_type": "SOCKS5",
7  "proxy_ip": "1.1.1.1",
8  "proxy_port": 12345,
9  "update_url": "https://link-to-update-proxy.com/api/update"
10}
11
12const options = {
13  method: "PUT",
14  headers: {
15    "X-Token": "Your Token", 
16    "Content-Type": "application/json"
17  }, 
18  body: JSON.stringify(body)
19};
20
21fetch(url, options)
22  .then((response) => {
23    response.json().then((data) => {
24      console.log(data);
25    });
26  })
27  .catch((error) => {
28    console.error(error);
29  });

Ответ

Данные ответа

Ответ
Название
Тип / Значение
Описание
data
Proxy
Обновленная прокси

Пример ответа

1{
2    "data": {
3        "user_id": "***privacy***",
4        "id": "***privacy***",
5        "folder_id": "***privacy***",
6        "proxy_name": "Proxy",
7        "proxy_type": "SOCKS5",
8        "proxy_ip": "1.1.1.1",
9        "proxy_port": 12345,
10        "proxy_username": null,
11        "proxy_password": null,
12        "update_url": "https://link-to-update-proxy.com/api/update",
13        "geo_info": null,
14        "last_check_at": null,
15        "created_at": "2024-01-05T15:30:42.998533Z",
16        "updated_at": "2024-01-05T15:30:42.998533Z",
17        "profiles": null
18    }
19}

Типы

Proxy
Название
Тип / Значение
Описание
proxy_name
String
Name
proxy_type
String
Type (HTTP, SOCKS4, SOCKS5, SSH)
proxy_ip
String
IP
proxy_port
Number
Port
proxy_username
String?
Username
proxy_password
String?
Password
proxy_geo
Geolocation?
Geolocation
update_url
String?
URL to renew proxy IP
*Types that end with a question mark (?) are optional.*

Geolocation
Название
Тип / Значение
Описание
ip
String
IP
country
String
Country
region
String
Region
city
String
City
zipcode
String
Zipcode
timezone
String
Timezone
latitude
Number
Latitude
longitude
Number
Longitude