Proxies

Список всех доступных методов для взаимодействия с API.

PUT

Изменить местоположение прокси-сервера

/package/proxy/{id}/{proxyIndex}/location

Переместить уже сгенерированные прокси с оплатой за ГБ в другую страну, регион или город без замены существующих.

Прокси сохраняют свой хост, порт, логин и пароль; меняется только место их выхода. proxyIndex принимает один индекс, список, разделенный запятыми, или all. Отправьте cities: [] (и regions: []), чтобы исключить город из пакета.

Для этого метода – нужна авторизация!
Вы можете использовать собственный ключ API, который можно получить в панели управления.
Для этого метода - нужны разрешения -packages-proxies.update
При создании API токена в панели управления вы можете выбрать определенные разрешения (например: запретить токену делать заказ).
Также список разрешений можно получить в нашей документации.

Способ запроса

PUThttps://api.stableproxy.com/v2/package/proxy/{id}/{proxyIndex}/location

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

ИдентификаторПравилаПример
countriesНе обязательноnullablearray{"UA": 10, "PL": 20}
regionsНе обязательноnullablearraydistinct7
citiesНе обязательноnullablearraydistinct10
countries.*Не обязательноdistinctstringcountry_code{"UA": 10, "PL": 20}
regions.*stringrequired101
cities.*stringrequired92
id1required19
proxyIndex1required65

Примеры кода

1const baseUrl = "https://api.stableproxy.com/v2";
2const response = await fetch(baseUrl + "/package/proxy/{id}/{proxyIndex}/location", {
3 method: "PUT",
4 headers: {
5 "Authorization": "API-Token [YOUR TOKEN]",
6 "Content-Type": "application/json"
7 },
8 body: JSON.stringify({
9 "countries": "{\"UA\": 10, \"PL\": 20}",
10 "regions": 7,
11 "cities": 10,
12 "countries.*": "{\"UA\": 10, \"PL\": 20}",
13 "regions.*": 101,
14 "cities.*": 92
15 })
16});
17const data = await response.json();
PUT

Изменить пул прокси-серверов

/package/proxy/{id}/{proxyIndex}/pool
Устарел

Этот метод ещё работает, но в API v3 есть более новый.

Используйте метод v3

Изменение пула для уже добавленного прокси-сервера домашнего типа.

Передача параметра pool_id=null приводит к возврату к пулу по умолчанию. Применимо только к типам пакетов residential_gb и residential_city_gb.

Для этого метода – нужна авторизация!
Вы можете использовать собственный ключ API, который можно получить в панели управления.
Для этого метода - нужны разрешения -packages-proxies.update
При создании API токена в панели управления вы можете выбрать определенные разрешения (например: запретить токену делать заказ).
Также список разрешений можно получить в нашей документации.

Способ запроса

PUThttps://api.stableproxy.com/v2/package/proxy/{id}/{proxyIndex}/pool

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

ИдентификаторПравилаПример
pool_idНе обязательноnullablestring22
id1required81
proxyIndex1required93

Примеры кода

1const baseUrl = "https://api.stableproxy.com/v2";
2const response = await fetch(baseUrl + "/package/proxy/{id}/{proxyIndex}/pool", {
3 method: "PUT",
4 headers: {
5 "Authorization": "API-Token [YOUR TOKEN]",
6 "Content-Type": "application/json"
7 },
8 body: JSON.stringify({
9 "pool_id": 22
10 })
11});
12const data = await response.json();
GET

Получить заметку

/package/note/{id}/{proxyIndex}
Устарел

Этот метод ещё работает, но в API v3 есть более новый.

Используйте метод v3

Вы можете ознакомиться с примечанием о доверенности.

Для этого метода – нужна авторизация!
Вы можете использовать собственный ключ API, который можно получить в панели управления.
Для этого метода - нужны разрешения -packages.set-note
При создании API токена в панели управления вы можете выбрать определенные разрешения (например: запретить токену делать заказ).
Также список разрешений можно получить в нашей документации.

Способ запроса

GEThttps://api.stableproxy.com/v2/package/note/{id}/{proxyIndex}

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

ИдентификаторПравилаПример
noteНе обязательноnullablestring98
id1required6
proxyIndex1required95

Примеры кода

1const baseUrl = "https://api.stableproxy.com/v2";
2const response = await fetch(baseUrl + "/package/note/{id}/{proxyIndex}", {
3 method: "GET",
4 headers: {
5 "Authorization": "API-Token [YOUR TOKEN]",
6 "Content-Type": "application/json"
7 }
8});
9const data = await response.json();

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

Success response200application/json
{
  "data": {
    "note": "A note"
  },
  "good": true,
  "timestamp": 1731487566,
  "cause": {
    "type": "user",
    "user_id": 1,
    "token_id": 9845,
    "token_sign": "edd87db549cd52292a47ad455bbea947"
  }
}
PUT

Изменить весь пул прокси-серверов

/package/proxy/{id}/pool
Устарел

Этот метод ещё работает, но в API v3 есть более новый.

Используйте метод v3

Одновременное изменение пула для ВСЕХ прокси в пакете.

Происходит перебор всех подпользователей и обновление значения pool_id для каждого прокси. Передача значения pool_id=null приводит к удалению явно указанного пула (восстанавливается маршрутизация по умолчанию, заданная вышестоящим уровнем). Применимо только к типам пакетов residential_gb и residential_city_gb.

Для этого метода – нужна авторизация!
Вы можете использовать собственный ключ API, который можно получить в панели управления.
Для этого метода - нужны разрешения -packages-proxies.update
При создании API токена в панели управления вы можете выбрать определенные разрешения (например: запретить токену делать заказ).
Также список разрешений можно получить в нашей документации.

Способ запроса

PUThttps://api.stableproxy.com/v2/package/proxy/{id}/pool

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

ИдентификаторПравилаПример
pool_idНе обязательноnullablestring47
id1required89

Примеры кода

1const baseUrl = "https://api.stableproxy.com/v2";
2const response = await fetch(baseUrl + "/package/proxy/{id}/pool", {
3 method: "PUT",
4 headers: {
5 "Authorization": "API-Token [YOUR TOKEN]",
6 "Content-Type": "application/json"
7 },
8 body: JSON.stringify({
9 "pool_id": 47
10 })
11});
12const data = await response.json();
GET

Получить пулы прокси-серверов

/package/proxy/{id}/pools
Устарел

Этот метод ещё работает, но в API v3 есть более новый.

Используйте метод v3

Получить доступные пулы прокси для пакета. Применимо только к типам пакетов «residential_gb» и «residential_city_gb».

Для этого метода – нужна авторизация!
Вы можете использовать собственный ключ API, который можно получить в панели управления.
Для этого метода - нужны разрешения -packages-proxies.read
При создании API токена в панели управления вы можете выбрать определенные разрешения (например: запретить токену делать заказ).
Также список разрешений можно получить в нашей документации.

Способ запроса

GEThttps://api.stableproxy.com/v2/package/proxy/{id}/pools

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

ИдентификаторПравилаПример
id1required87

Примеры кода

1const baseUrl = "https://api.stableproxy.com/v2";
2const response = await fetch(baseUrl + "/package/proxy/{id}/pools", {
3 method: "GET",
4 headers: {
5 "Authorization": "API-Token [YOUR TOKEN]",
6 "Content-Type": "application/json"
7 }
8});
9const data = await response.json();