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

Базовый URL

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

Запрос

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

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

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

Параметры запроса
Название
Тип / Значение
Описание
folderId
UUID
ID папки

Тело запроса

Тело
Название
Тип / Значение
Описание
proxies
Array<Proxy>
Массив прокси

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

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

Ответ

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

Ответ
Название
Тип / Значение
Описание
data
Array<Proxy>
Массив созданных прокси

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

1
2{
3    "data": [
4        {
5            "user_id": "***privacy***",
6            "id": "***privacy***",
7            "folder_id": "***privacy***",
8            "proxy_name": "Proxy",
9            "proxy_type": "SOCKS5",
10            "proxy_ip": "127.0.0.1",
11            "proxy_port": 1080,
12            "proxy_username": null,
13            "proxy_password": null,
14            "update_url": null,
15            "geo_info": null,
16            "last_check_at": null,
17            "created_at": "2024-01-05T15:30:42.998533Z",
18            "updated_at": "2024-01-05T15:30:42.998533Z",
19            "profiles": null
20        }
21    ]
22}
23

Типы

Proxy
Название
Тип / Значение
Описание
proxy_name
String
Название
proxy_type
String
Тип (HTTP, SOCKS4, SOCKS5, SSH)
proxy_ip
String
IP-адрес
proxy_port
Number
Порт
proxy_username
String?
Имя пользователя
proxy_password
String?
Пароль
proxy_geo
Geolocation?
Информация о геолокации
update_url
String?
URL для обновления IP-адреса прокси
*Типы, оканчивающиеся вопросительным знаком (?), являются необязательными.*

Geolocation
Название
Тип / Значение
Описание
ip
String
IP-адрес
country
String
Страна
region
String
Регион
city
String
Город
zipcode
String
Почтовый индекс
timezone
String
Часовой пояс
latitude
Number
Широта
longitude
Number
Долгота