API Endpoints
Proxy
Create proxy

Base URL

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

Request

Request headers

Headers
Название
Тип / Значение
Описание
X-Token
String
Auth token
Content-Type
application/json

URL Parameters

Query parameters
Название
Тип / Значение
Описание
folder_id
UUID
The ID of the folder

Request body

Body
Название
Тип / Значение
Описание
proxies
Array<Proxy>
Array of proxies

Request examples

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  });

Response

Response data

Response
Название
Тип / Значение
Описание
data
Array<Proxy>
Array of created proxies

Response example

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

Types

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