🎁 Бесплатный тест на 12 часов для каждого нового аккаунта · 🇩🇪 Настоящие IP немецких 4G-операторов · ♾️ Безлимитный трафик · безлимитные ротации · ₿ Оплата криптой или картой

Справочник API

Покупайте, ротируйте и управляйте немецкими 4G-прокси программно. Небольшой предсказуемый REST API — JSON на входе, JSON на выходе.

Базовый URLhttps://api.proxion.io/v1

Все эндпоинты версионированы под /v1 и доступны только по HTTPS.

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

Передавайте API-ключ в заголовке Authorization в каждом запросе. Ключи создаются и отзываются в кабинете в разделе «API-ключи». Ключи секретны — никогда не размещайте их в клиентском коде.

http
Authorization: Bearer prx_live_xxx

Тестовые ключи (prx_test_…) создают прокси, которые работают так же, но никогда не оплачиваются.

Соглашения

Весь API следует нескольким единым правилам — вызвав один эндпоинт, вы знаете все.

Везде JSON

Тела запросов и ответов — JSON в UTF-8. Время — ISO-8601 в UTC (напр. 2026-07-22T10:00:00Z).

Предсказуемые ошибки

Ошибки используют стандартные HTTP-коды и возвращают { "error": { "code", "message" } }. Поле code стабильно, по нему можно ветвиться; message — для человека.

Курсорная пагинация

Списки принимают limit (1–100) и starting_after=<id> и возвращают { "data": [...], "has_more": bool }.

Лимиты запросов

Каждый авторизованный ответ содержит X-RateLimit-Limit и X-RateLimit-Remaining — 120 запросов в минуту на ключ. При превышении — 429 с Retry-After; повторите после сброса окна.

Объект прокси

Покупка возвращает объект прокси. Это единственный ресурс, с которым вы работаете, — его доступы не меняются, пока вы не сделаете ротацию.

ПолеТипОписание
idstringУникальный идентификатор, напр. px_a1b2c3d4.
planstringОдин из 1d, 7d, 30d (или trial).
statusstringactive — пока работает, expired — после окончания срока, released — если освобождён досрочно.
hoststringХост прокси, напр. de1.proxion.io.
portintegerПорт для HTTP и SOCKS5.
usernamestringЛогин для авторизации логин:пароль.
passwordstringПароль для авторизации логин:пароль.
protocolsstring[]Поддерживаемые протоколы: ["http", "socks5"].
countrystringКод страны ISO — всегда DE.
os_profilestringПрофиль TCP-отпечатка: none, windows, macos, android, ios или linux.
allowed_ipsstring[]IP / CIDR-диапазоны, которым разрешён доступ без логин:пароль (макс. 20).
created_atstringКогда прокси был выдан.
expires_atstringКогда доступ закончится и IP освободится.

Эндпоинты

Восемь эндпоинтов покрывают весь цикл: узнать тарифы, купить прокси, посмотреть его, сменить IP, изменить настройки, продлить и освободить досрочно.

GET/v1/plans

Список тарифов

Возвращает доступные сроки и цены в центах. Без авторизации.

Запрос
curl https://api.proxion.io/v1/plans
Ответ
{
  "data": [
    { "plan": "1d",  "price_cents": 600  },
    { "plan": "7d",  "price_cents": 2900 },
    { "plan": "30d", "price_cents": 7900 }
  ]
}
POST/v1/proxies

Купить прокси

Выдаёт новый немецкий 4G-прокси на выбранный срок и сразу возвращает его с доступами. Тело: { "plan": "7d" }.

Запрос
curl -X POST https://api.proxion.io/v1/proxies \
  -H "Authorization: Bearer prx_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "plan": "7d" }'
Ответ
{
  "id": "px_a1b2c3d4",
  "plan": "7d",
  "status": "active",
  "host": "de1.proxion.io",
  "port": 24915,
  "username": "px_9f3a2",
  "password": "b7c1d9e0f2a4",
  "protocols": ["http", "socks5"],
  "country": "DE",
  "os_profile": "none",
  "allowed_ips": [],
  "created_at": "2026-07-22T10:00:00Z",
  "expires_at": "2026-07-29T10:00:00Z"
}
GET/v1/proxies

Список прокси

Возвращает ваши прокси, новые сверху. Фильтр ?status=active|expired, пагинация через limit / starting_after.

Запрос
curl "https://api.proxion.io/v1/proxies?status=active&limit=20" \
  -H "Authorization: Bearer prx_live_xxx"
Ответ
{
  "data": [ { "id": "px_a1b2c3d4", "status": "active", "...": "..." } ],
  "has_more": false
}
GET/v1/proxies/{id}

Получить прокси

Возвращает один прокси по id с текущими доступами и сроком.

Запрос
curl https://api.proxion.io/v1/proxies/px_a1b2c3d4 \
  -H "Authorization: Bearer prx_live_xxx"
Ответ
{
  "id": "px_a1b2c3d4",
  "status": "active",
  "host": "de1.proxion.io",
  "port": 24915,
  "expires_at": "2026-07-29T10:00:00Z"
}
POST/v1/proxies/{id}/rotate

Сменить IP

Назначает прокси новый мобильный IP, доступы остаются прежними. Чтобы сохранить текущий IP, просто продолжайте подключаться.

Запрос
curl -X POST https://api.proxion.io/v1/proxies/px_a1b2c3d4/rotate \
  -H "Authorization: Bearer prx_live_xxx"
Ответ
{
  "id": "px_a1b2c3d4",
  "host": "de3.proxion.io",
  "port": 28104,
  "username": "px_9f3a2",
  "password": "b7c1d9e0f2a4"
}
POST/v1/proxies/{id}/extend

Продлить прокси

Добавляет срок активному прокси — IP и доступы сохраняются после исходного окончания. Тело: { "plan": "7d" }.

Запрос
curl -X POST https://api.proxion.io/v1/proxies/px_a1b2c3d4/extend \
  -H "Authorization: Bearer prx_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "plan": "7d" }'
Ответ
{
  "id": "px_a1b2c3d4",
  "status": "active",
  "expires_at": "2026-08-05T10:00:00Z"
}
PATCH/v1/proxies/{id}

Изменить настройки

Задаёт профиль TCP-отпечатка ОС (none, windows, macos, android, ios, linux) и/или белый список IP. Неуказанные поля не меняются; allowed_ips заменяет весь список.

Запрос
curl -X PATCH https://api.proxion.io/v1/proxies/px_a1b2c3d4 \
  -H "Authorization: Bearer prx_live_xxx" \
  -d '{ "os_profile": "windows", "allowed_ips": ["203.0.113.7", "10.0.0.0/24"] }'
Ответ
{
  "id": "px_a1b2c3d4",
  "status": "active",
  "os_profile": "windows",
  "allowed_ips": ["203.0.113.7", "10.0.0.0/24"]
}
DELETE/v1/proxies/{id}

Освободить прокси

Досрочно завершает прокси и освобождает IP. Необратимо; остаток срока не возвращается.

Запрос
curl -X DELETE https://api.proxion.io/v1/proxies/px_a1b2c3d4 \
  -H "Authorization: Bearer prx_live_xxx"
Ответ
{
  "id": "px_a1b2c3d4",
  "status": "released"
}

Подключение к прокси

Используйте полученные хост, порт, логин и пароль в любом HTTP- или SOCKS5-клиенте. Одни и те же доступы работают для обоих протоколов.

bash
# HTTP
curl -x http://px_9f3a2:b7c1d9e0f2a4@de1.proxion.io:24915 \
  https://api.ipify.org
# → 185.XX.XX.XX (DE · 4G)

# SOCKS5
curl -x socks5://px_9f3a2:b7c1d9e0f2a4@de1.proxion.io:24915 \
  https://api.ipify.org

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

Купите прокси на 7 дней и отправьте через него первый запрос — всего два вызова.

bash
# 1. Buy a 7-day proxy
curl -X POST https://api.proxion.io/v1/proxies \
  -H "Authorization: Bearer prx_live_xxx" \
  -d '{ "plan": "7d" }'

# 2. Route a request through it
curl -x http://px_9f3a2:b7c1d9e0f2a4@de1.proxion.io:24915 \
  https://api.ipify.org
Написать нам