API Endpoints
Proxy
Edit proxy

Base URL

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

Request

Request headers

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

URL Parameters

Query parameters
Название
Тип / Значение
Описание
folderId
UUID
ID of the folder
proxyId
UUID
ID of the proxy to be edited

Request body

Look at Proxy type in the Types section

Request examples

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: "PATCH",
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  });

Response

Response data

Response
Название
Тип / Значение
Описание
data
Proxy
Updated proxy

Response example

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}

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