Справочник API
Покупайте, ротируйте и управляйте немецкими 4G-прокси программно. Небольшой предсказуемый REST API — JSON на входе, JSON на выходе.
Базовый URLhttps://api.proxion.io/v1
Все эндпоинты версионированы под /v1 и доступны только по HTTPS.
Аутентификация
Передавайте API-ключ в заголовке Authorization в каждом запросе. Ключи создаются и отзываются в кабинете в разделе «API-ключи». Ключи секретны — никогда не размещайте их в клиентском коде.
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; повторите после сброса окна.
Объект прокси
Покупка возвращает объект прокси. Это единственный ресурс, с которым вы работаете, — его доступы не меняются, пока вы не сделаете ротацию.
| Поле | Тип | Описание |
|---|
id | string | Уникальный идентификатор, напр. px_a1b2c3d4. |
plan | string | Один из 1d, 7d, 30d (или trial). |
status | string | active — пока работает, expired — после окончания срока, released — если освобождён досрочно. |
host | string | Хост прокси, напр. de1.proxion.io. |
port | integer | Порт для HTTP и SOCKS5. |
username | string | Логин для авторизации логин:пароль. |
password | string | Пароль для авторизации логин:пароль. |
protocols | string[] | Поддерживаемые протоколы: ["http", "socks5"]. |
country | string | Код страны ISO — всегда DE. |
os_profile | string | Профиль TCP-отпечатка: none, windows, macos, android, ios или linux. |
allowed_ips | string[] | IP / CIDR-диапазоны, которым разрешён доступ без логин:пароль (макс. 20). |
created_at | string | Когда прокси был выдан. |
expires_at | string | Когда доступ закончится и IP освободится. |
Эндпоинты
Восемь эндпоинтов покрывают весь цикл: узнать тарифы, купить прокси, посмотреть его, сменить IP, изменить настройки, продлить и освободить досрочно.
Список тарифов
Возвращает доступные сроки и цены в центах. Без авторизации.
curl https://api.proxion.io/v1/plans
{
"data": [
{ "plan": "1d", "price_cents": 600 },
{ "plan": "7d", "price_cents": 2900 },
{ "plan": "30d", "price_cents": 7900 }
]
}
Купить прокси
Выдаёт новый немецкий 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"
}
Список прокси
Возвращает ваши прокси, новые сверху. Фильтр ?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
}
Получить прокси
Возвращает один прокси по 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"
}
Изменить настройки
Задаёт профиль 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"]
}
Освободить прокси
Досрочно завершает прокси и освобождает 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-клиенте. Одни и те же доступы работают для обоих протоколов.
# 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 дней и отправьте через него первый запрос — всего два вызова.
# 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