Справочник 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>
Массив прокси

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

1var myHeaders = new Headers();
2
3myHeaders.append("Content-Type", "application/json");
4myHeaders.append("X-Token", "YOUR_TOKEN_HERE");
5
6var raw = JSON.stringify({
7"proxies": [
8{
9"proxy_name": "Proxy 1",
10"proxy_type": "HTTP",
11"proxy_ip": "1.1.1.1",
12"proxy_port": 8080,
13}
14]
15});
16
17var folderId = "cf4003e0-e630-4bc3-9961-61d81c2f3aa5";
18
19var requestOptions = {
20method: 'POST',
21headers: myHeaders,
22body: raw,
23redirect: 'follow'
24};
25
26fetch("https://apiv2.empr.cloud/api/v1/folders/" + folderId + "/proxies, requestOptions)
27.then(response => response.text())
28.then(result => console.log(result))
29.catch(error => console.log('error', error));

Ответ

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

Ответ
Название
Тип / Значение
Описание
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
Долгота