Версия: 1.0.0Обновлено:
ProxyMaxy выдаёт доступ к прокси через личный кабинет. Полный путь от регистрации до первого запроса занимает несколько минут.
Если заказ остаётся в статусе ожидания дольше обычного, проверьте баланс: недостаток средств блокирует активацию.
Прокси аутентифицируют клиента по логину и паролю. Пара выдаётся на заказ и видна только в вашем личном кабинете.
Для доступа к REST API используется отдельный API-ключ. Он выпускается в настройках и показывается один раз — сохраните его сразу.
Строка доступа собирается из адреса шлюза, порта и вашей пары логин-пароль. Поддерживаются форматы host:port:user:pass, user:pass@host:port и готовая команда curl.
В карточке заказа доступна выгрузка всех комбинаций локация × протокол одним файлом.
Выбор страны и режим ротации задаются при оформлении заказа и отражаются в выданных портах.
Точные параметры ротации и список стран для вашего заказа отображаются в его карточке — они зависят от поставщика и могут отличаться между типами прокси.
Ответы REST API используют единый конверт: поле ok отличает успех от ошибки, а поле error содержит машиночитаемый код.
{ "ok": false, "error": { "code": "VALIDATION", "message": "..." } }Ошибки самих прокси-соединений возвращаются протоколом: 407 означает проблему с аутентификацией, обрыв соединения — недоступность выбранного узла.
REST API ограничивает частоту запросов по API-ключу. При превышении лимита возвращается код RATE_LIMITED.
Числовые значения лимитов будут опубликованы вместе с полным описанием REST API.
Текущий пользователь и безопасная метаинформация профиля.
{
"ok": true,
"version": "v1",
"requestId": "req_example",
"data": {
"id": "usr_example",
"email": "user@example.invalid"
}
}Авторитетный USD-баланс кошелька.
{
"ok": true,
"version": "v1",
"requestId": "req_example",
"data": {
"amountUsd": "10.00"
}
}Тарифы и возможности без себестоимости и данных маржи.
{
"ok": true,
"version": "v1",
"requestId": "req_example",
"data": {
"products": []
}
}Пагинированные заказы владельца.
{
"ok": true,
"version": "v1",
"requestId": "req_example",
"data": {
"items": [],
"nextCursor": null
}
}Создаёт заказ по конфигурации и идемпотентному ключу.
Один принадлежащий владельцу заказ; чужой и отсутствующий дают одинаковый 404.
{
"ok": true,
"version": "v1",
"requestId": "req_example",
"data": {
"id": "ord_example",
"status": "created"
}
}История расчётов и возвратов без внутренних строк провайдера.
{
"ok": true,
"version": "v1",
"requestId": "req_example",
"data": {
"items": [],
"nextCursor": null
}
}Подписки, состояния и безопасная сводка доступа.
{
"ok": true,
"version": "v1",
"requestId": "req_example",
"data": {
"items": [],
"nextCursor": null
}
}Детали одной подписки и доступные действия.
{
"ok": true,
"version": "v1",
"requestId": "req_example",
"data": {
"id": "ent_example",
"endpoints": [
{
"host": null,
"port": null
}
]
}
}Остатки трафика и лоты с точными byte-значениями строками.
{
"ok": true,
"version": "v1",
"requestId": "req_example",
"data": {
"availableBytes": "0",
"lots": []
}
}Учётные данные, пополнение, настройка доступа или отмена.
{
"action": "credentials"
}{
"ok": true,
"version": "v1",
"requestId": "req_example",
"data": {
"action": "credentials",
"status": "completed"
}
}Playground отправляет запросы только на текущий origin.
Ключ хранится только в памяти этой вкладки и не попадает в URL или localStorage.
v1 · 2026-08-28