Документация для разработчиков

PROXIES.SX API Документация

Полное руководство по API для программного управления мобильными прокси. Создавайте порты, меняйте IP, отслеживайте использование — автоматизируйте вашу инфраструктуру.

Beta API

API находится в бета-версии и активно разрабатывается. Эндпоинты и форматы ответов могут измениться. По любым вопросам обращайтесь в поддержку.

Базовый URL

https://api.proxies.sx/v1

Аутентификация

Все API-запросы требуют аутентификации через API-ключ. Получите ключ в личном кабинете .

Заголовок: X-API-Key: psx_your_api_key_here

Права доступа API-ключа

ПраваОписание
ports:readЧтение информации о портах
ports:writeСоздание, обновление, удаление портов
ports:rotateРотация порта на новое устройство
billing:readЧтение счетов и истории платежей
traffic:readЧтение данных об использовании трафика
account:readЧтение информации об аккаунте

Быстрый старт

Шаг 1: Проверка ресурсов

curl https://api.proxies.sx/v1/account/summary \
  -H "X-API-Key: psx_your_key"

Шаг 2: Получение доступных локаций

curl https://api.proxies.sx/v1/countries/with-devices \
  -H "X-API-Key: psx_your_key"

Шаг 3: Создание порта

curl -X POST https://api.proxies.sx/v1/ports \
  -H "X-API-Key: psx_your_key" \
  -H "Content-Type: application/json" \
  -d '{"countryId":"COUNTRY_ID","expiresAt":86400}'

Шаг 4: Использование прокси

# HTTP прокси
http://proxyLogin:proxyPassword@serverIp:httpPort

# SOCKS5 прокси
socks5://proxyLogin:proxyPassword@serverIp:socksPort

Шаг 5: Ротация IP при необходимости

# Вариант A: API ротация (требует аутентификации)
curl -X POST https://api.proxies.sx/v1/ports/PORT_ID/rotate \
  -H "X-API-Key: psx_your_key"

# Вариант B: Токен ротации (без аутентификации!)
curl https://api.proxies.sx/rotate/YOUR_ROTATION_TOKEN

Справочные данные

GET/v1/countries/with-devicesПрава: ports:read

Получить страны с доступными устройствами и количество свободных

Пример запроса
curl https://api.proxies.sx/v1/countries/with-devices \
  -H "X-API-Key: psx_your_key"
Ответ
[
  {
    "_id": "69276bf1f547dfc948699263",
    "name": "Germany",
    "code": "DE",
    "iso3": "DEU",
    "phoneCode": "+49",
    "freeDeviceCount": 26
  }
]
GET/v1/carriers/country/:countryId?withDevice=trueПрава: ports:read

Получить операторов страны с количеством свободных устройств

Пример запроса
curl "https://api.proxies.sx/v1/carriers/country/69276bf1f547dfc948699263?withDevice=true" \
  -H "X-API-Key: psx_your_key"
GET/v1/tariffsПрава: ports:read

Получить доступные тарифы и цены (с полями для разработчиков)

Пример запроса
curl https://api.proxies.sx/v1/tariffs \
  -H "X-API-Key: psx_your_key"

Управление портами

GET/v1/portsПрава: ports:read

Список всех портов с деталями подключения

Пример запроса
curl https://api.proxies.sx/v1/ports \
  -H "X-API-Key: psx_your_key"
POST/v1/portsПрава: ports:write

Создать новый порт (требуется купленный слот)

Тело запроса
{
  "countryId": "69276bf1f547dfc948699263",
  "expiresAt": 86400,
  "carrierId": "carrier_id",
  "osFingerprint": "windows:1"
}
DELETE/v1/ports/:idПрава: ports:write

Удалить порт

Пример запроса
curl -X DELETE https://api.proxies.sx/v1/ports/675123abc... \
  -H "X-API-Key: psx_your_key"

Ротация IP

POST/v1/ports/:id/rotateПрава: ports:rotate

Ротация порта для получения нового IP

Пример запроса
curl -X POST https://api.proxies.sx/v1/ports/PORT_ID/rotate \
  -H "X-API-Key: psx_your_key"
PATCH/v1/ports/:id/rotation-settingsПрава: ports:write

Включить/настроить авто-ротацию

Тело запроса
{
  "enabled": true,
  "intervalSeconds": 1800
}
GET/v1/ports/:id/rotation-historyПрава: ports:read

Получить историю ротаций порта

Пример запроса
curl https://api.proxies.sx/v1/ports/PORT_ID/rotation-history \
  -H "X-API-Key: psx_your_key"

Аккаунт и биллинг

GET/v1/accountПрава: account:read

Полные данные аккаунта

Пример запроса
curl https://api.proxies.sx/v1/account \
  -H "X-API-Key: psx_your_key"
GET/v1/account/usage?period=30dПрава: traffic:read

Детализация трафика

Пример запроса
curl "https://api.proxies.sx/v1/account/usage?period=30d" \
  -H "X-API-Key: psx_your_key"

Форматы подключения

HTTP Прокси
http://логин:пароль@IP_сервера:HTTP_порт
SOCKS5 Прокси
socks5://логин:пароль@IP_сервера:SOCKS5_порт

Готовы начать интеграцию?

Получите API-ключ в личном кабинете и начинайте разработку.

Получить API-ключСвязаться с поддержкой