Документация API Proxy302

Все эндпоинты отвечают HTTP 200 и возвращают конверт {code, msg, data}: code === 0 — успех; при любом другом коде data равен null. Суммы — PTC с точностью до 3 знаков, трафик — десятичные строки байт, время — Unix-секунды.

Официальный MCP-сервер

Поддерживает команда Proxy302, код открыт на GitHub. Cursor и VS Code добавляют сервер в один клик, Claude.ai и ChatGPT подключаются через веб-коннектор, ничего устанавливать не нужно.

  • proxy302-mcp (Официальный) — Позволяет AI-инструментам — Claude, ChatGPT, Cursor, VS Code и другим — проверять расход, получать прокси, менять IP и проверять чистоту IP. Эти инструменты ничего не списывают. GitHub · Добавить в Cursor · Установить в VS Code
    Веб-коннектор (Claude.ai, ChatGPT): https://mcp.proxy302.com/mcp Добавьте адрес как свой коннектор и вставьте <key id>:<secret> на странице авторизации.
    Claude Code (затем выполните /mcp, чтобы войти): claude mcp add --transport http proxy302 https://mcp.proxy302.com/mcp
    Ключ в заголовке (Claude Code): claude mcp add --transport http proxy302 https://proxy302.com/v1/mcp --header "Authorization: Bearer <key id>:<secret>"
    Локальный сервер (Claude Code): claude mcp add proxy302 -e PROXY302_API_KEY="<key id>:<secret>" -- npx -y github:proxy302/proxy302-mcp
    Аккаунты с пополнением получают 1 PTC за первое использование через MCP, один раз на аккаунт.

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

Выпуск Basic-заголовка и сведения о текущем API-ключе. Если есть только секрет (строка p302_), отправьте Authorization: Bearer <секрет>.

  • GET /open_api/v3/user/users/token — Кодирует ключ в значение заголовка Authorization: Basic
  • GET /open_api/v3/user/users/me — Идентичность API-ключа (name / email / uid)

Справочники

Коды регионов и тарифы статики перед покупкой.

  • GET /open_api/v3/proxy/area/{area_type} — Регионы по уровню (country / state / city)
  • GET /open_api/v3/proxy/payway/{payway_name} — Тарифы (payway) для статики

Покупка

Четыре линии: статический трафик, статический IP, динамический трафик и динамика по региону. Параметры — в JSON-теле и/или query; при конфликте приоритет у тела.

  • POST /open_api/v3/proxy/api/proxy/static/traffic — Купить статический трафик
  • POST /open_api/v3/proxy/api/proxy/static/ip — Купить статический IP (по сроку)
  • POST /open_api/v3/proxy/api/proxy/dynamic/traffic — Купить динамический трафик
  • POST /open_api/v3/proxy/api/proxy/dynamic/ip/by_area — Купить динамический IP по региону

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

Постраничный список прокси: фильтры, сортировка, мягкое удаление.

  • GET /open_api/v3/proxy/tokens/{generate}/{proxy_type} — Список токенов прокси (постранично)

Трафик и расходы

Расход по дням, графики использования и баланс пулов.

  • GET /open_api/v3/proxy/traffic/consume/log/summary — Расход трафика по дням и пулам
  • GET /open_api/v3/proxy/summary/proxies/{proxy_type}/{statistics_type} — Серии графиков использования
  • GET /open_api/v3/proxy/summary/cost/{statistics_type} — Расходы по категориям (PTC)
  • GET /open_api/v3/proxy/traffic/pool/remaining — Остаток трафика в пулах

Продление

Платное продление статики и переключатель автопродления.

  • POST /open_api/v3/proxy/token/renew/{token_id} — Продлить статический IP (платно)
  • PUT /open_api/v3/proxy/token/renew/{token_id} — Переключить автопродление

Каталог ISP

Варианты ISP для премиум-таргетинга.

  • GET /open_api/v3/proxy/isp/catalog — Список ISP (можно по стране)

Сброс сессий

Смена выходного IP sticky-ключей без перевыпуска (1-100 токенов).

  • DELETE /open_api/v3/proxy/sessions — Пакетный сброс sticky-сессий (token_ids в теле)

Удаление прокси

Удаление своих прокси-подключений (статика или динамика), как «Удалить» в консоли: отменить нельзя, неиспользованные дни статического IP не возвращаются.

  • DELETE /open_api/v3/proxy/token/{token_id} — Удалить одно подключение
  • DELETE /open_api/v3/proxy/tokens — Пакетное удаление (token_ids в теле)

Белый список IP

Белый список IP на токен (не более 5).

  • GET /open_api/v3/proxy/token/{token_id}/ip-whitelist — IP из белого списка токена
  • POST /open_api/v3/proxy/token/{token_id}/ip-whitelist — Привязать IP
  • DELETE /open_api/v3/proxy/token/{token_id}/ip-whitelist/{ip} — Отвязать IP

Лимиты трафика (субаккаунты)

У каждого подключения свои логин и пароль; задайте лимит трафика — и оно работает как субаккаунт для коллеги, программы или вашего клиента, останавливаясь при исчерпании. Лимит можно задать только динамическим подключениям с оплатой за трафик. Расход считается с момента установки (или обнуления) и учитывает трафик в пути, поэтому пачка подключений не превысит лимит. При исчерпании HTTP-прокси отвечает 403, SOCKS5 отклоняет соединение.

  • GET /open_api/v3/proxy/traffic-caps — Все подключения аккаунта с лимитом
  • GET /open_api/v3/proxy/token/{token_id}/traffic-cap — Лимит и расход подключения
  • POST /open_api/v3/proxy/token/{token_id}/traffic-cap — Задать или изменить лимит
  • DELETE /open_api/v3/proxy/token/{token_id}/traffic-cap — Снять лимит

Proxy302

PROXY302