REST API v2
Автоматизируйте покупку, продление и выгрузку прокси. Ключ API генерируется в личном кабинете после регистрации.
Базовый URL
https://api.svyaz.mom/v2/
Все запросы — HTTPS. Аутентификация через заголовок Authorization: Bearer YOUR_API_KEY. Формат ответа — JSON. Лимит: 60 запросов в минуту на ключ.
Эндпоинты
Методы API
| Метод | Эндпоинт | Описание |
|---|---|---|
| GET | /balance | Текущий баланс аккаунта в USD |
| GET | /stock | Наличие прокси по странам и типам |
| GET | /proxies | Список активных прокси с фильтрами |
| GET | /proxies/{id} | Детали одного прокси по ID |
| POST | /order | Создать заказ: type, country, count, period |
| POST | /proxies/{id}/renew | Продлить прокси на указанный период |
| DELETE | /proxies/{id} | Досрочно отключить прокси (без возврата) |
| GET | /export | Выгрузка списка в txt/csv/json |
Примеры
Запросы
Создание заказа (cURL)
curl -X POST https://api.svyaz.mom/v2/order \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"type":"ipv4","country":"de","count":5,"period":30}'
Python
import requests
API_KEY = "YOUR_API_KEY"
BASE = "https://api.svyaz.mom/v2"
resp = requests.post(
f"{BASE}/order",
headers={"Authorization": f"Bearer {API_KEY}"},
json={"type": "ipv6", "country": "nl", "count": 10, "period": 30}
)
data = resp.json()
print(data["order_id"], data["total_usd"])
Node.js
const API_KEY = "YOUR_API_KEY";
const res = await fetch("https://api.svyaz.mom/v2/proxies", {
headers: { Authorization: `Bearer ${API_KEY}` }
});
const proxies = await res.json();
proxies.items.forEach(p => {
console.log(`${p.host}:${p.port}:${p.login}:${p.password}`);
});
Пример ответа POST /order
{
"status": "ok",
"order_id": "ord_8f3a2b1c",
"total_usd": 16.80,
"proxies": [
{"id": "px_001", "host": "185.22.34.89", "port": 1080,
"login": "user_a1b2", "password": "pass_x9y8", "expires_at": "2026-07-24T12:00:00Z"}
]
}
Ошибки
Коды ответов
| Код | Ошибка | Описание |
|---|---|---|
| 200 | — | Успешный запрос |
| 400 | invalid_params | Некорректные параметры (type, country, count, period) |
| 401 | unauthorized | Неверный или отсутствующий API-ключ |
| 402 | insufficient_balance | Недостаточно средств на балансе |
| 404 | not_found | Прокси или заказ не найден |
| 409 | out_of_stock | Нет свободных адресов в выбранной стране |
| 429 | rate_limited | Превышен лимит 60 req/min |
| 500 | internal_error | Внутренняя ошибка — повторите запрос позже |
Формат ошибки: {"status":"error","code":"insufficient_balance","message":"..."}. Вопросы по интеграции: support@svyaz.mom.