Все эндпоинты отвечают HTTP 200 и возвращают конверт {code, msg, data}: code === 0 — успех; при любом другом коде data равен null. Суммы — PTC с точностью до 3 знаков, трафик — десятичные строки байт, время — Unix-секунды.
Поддерживает команда Proxy302, код открыт на GitHub. Cursor и VS Code добавляют сервер в один клик, Claude.ai и ChatGPT подключаются через веб-коннектор, ничего устанавливать не нужно.
https://mcp.proxy302.com/mcp Добавьте адрес как свой коннектор и вставьте <key id>:<secret> на странице авторизации.claude mcp add --transport http proxy302 https://mcp.proxy302.com/mcpclaude mcp add --transport http proxy302 https://proxy302.com/v1/mcp --header "Authorization: Bearer <key id>:<secret>"claude mcp add proxy302 -e PROXY302_API_KEY="<key id>:<secret>" -- npx -y github:proxy302/proxy302-mcpВыпуск Basic-заголовка и сведения о текущем API-ключе. Если есть только секрет (строка p302_), отправьте Authorization: Bearer <секрет>.
GET /open_api/v3/user/users/token — Кодирует ключ в значение заголовка Authorization: BasicGET /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 для премиум-таргетинга.
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 на токен (не более 5).
GET /open_api/v3/proxy/token/{token_id}/ip-whitelist — IP из белого списка токенаPOST /open_api/v3/proxy/token/{token_id}/ip-whitelist — Привязать IPDELETE /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