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

Змінити пул для вже доданого проксі-сервера типу «residential».

Вказання параметра 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();