НОВОЕ! |Один API-вызов — чистые данные. Парсеры не нужны.10 000 токенов бесплатно →

Платформа для разработчиков

API и MCP FineProxy

Автоматизируйте работу с прокси из своего кода или подключите AI-агента. Узнайте, какие операции поддерживаются, как устроены ограничения и как проверить существующую интеграцию перед сменой провайдера.

REST API49 операций OpenAPI
MCP-сервер49 инструментов агента
ДоступAPI-ключи с ограниченными правами

Одна платформа, два способа автоматизации

API и MCP используют одинаковые ключи FineProxy с ограниченными правами и открывают одни и те же клиентские процессы. Выбор зависит от того, кто будет ими управлять: ваше приложение или AI-агент.

REST · OpenAPI 3.1

Встройте FineProxy в своё приложение

Вызывайте документированные HTTP-методы из backend, скрипта, CI, внутренней панели или no-code-сценария. Актуальная клиентская спецификация доступна в кабинете.

Подходит, когда ваш код должен:
  • Выполнять предсказуемые процессы без AI-модели
  • Проверять запросы и ответы по схеме OpenAPI
  • Самостоятельно управлять повторами, очередями, логами и развёртыванием
Открыть документацию API

JSON-RPC 2.0 · Streamable HTTP

Дайте AI-агенту контролируемый доступ

Подключите Cursor, Claude, VS Code, Cline, n8n или другой MCP-клиент к серверу FineProxy. Агент получит только инструменты, разрешённые правами API-ключа.

Подходит, когда агент должен:
  • Проверять остатки, услуги, статистику и историю поддержки
  • Рассчитывать стоимость и выполнять одобренные операции
  • Диагностировать сбои и объяснять необходимые изменения
Открыть настройку MCP в кабинете

Проверьте текущую интеграцию до миграции

Скачайте один Markdown-файл, передайте его агенту разработки вместе с репозиторием и запустите готовый prompt. Первый этап проходит только на чтение: агент определит совместимость, необходимые адаптеры, блокеры и конкретные изменения в коде.

Prompt для аудита миграции без изменений
Изучи приложенный FineProxy Agent Pack и проверь этот репозиторий.

На первом этапе не изменяй код.

Найди все места, где настроен или вызывается текущий прокси-провайдер. Сопоставь каждый процесс с документированными возможностями FineProxy. Подготовь:
1. Полностью совместимые процессы.
2. Процессы, которым нужен адаптер или преобразование данных.
3. Неподдерживаемое или неясное поведение.
4. Необходимые права API FineProxy.
5. Точные файлы и участки кода, которые потребуется изменить.
6. Изменения авторизации и хранения секретов.
7. Поэтапный план миграции с откатом.
8. Интеграционные тесты перед переключением.

Не придумывай endpoints. Всё, что не подтверждено Agent Pack или актуальной спецификацией OpenAPI, вынеси в список вопросов.

Что должен проверить аудит

  1. 01Где инициализируется и вызывается текущий провайдер
  2. 02Различия в авторизации и хранении секретов
  3. 03Покупку, продление, отмену услуг и обновление IP
  4. 04Форматы списков, протоколы, порты и способы авторизации
  5. 05Выбор стран, allowlist и лимиты соединений
  6. 06Пагинацию, повторы, идемпотентность, ошибки и rate limits
  7. 07Зависимости от платежей, аналитики, поддержки и вебхуков
  8. 08План миграции и тестирования по файлам без изменения кода

Для реализации отдельных endpoints также передайте агенту актуальный файл OpenAPI из кабинета. Agent Pack намеренно не содержит ключей и приватных данных аккаунта.

Что можно автоматизировать

Публичная страница объясняет целые рабочие процессы, а не повторяет каждый endpoint. Для реализации отдельных запросов используйте актуальную спецификацию OpenAPI.

01

Покупка и выдача услуг

Проверяйте живые остатки, рассчитывайте точную стоимость набора стран и оплачивайте заказ с баланса кабинета.

  • Получать список стран и текущее количество доступных IP
  • Рассчитывать пакет из нескольких стран без списания средств
  • Покупать с защитой цены и ключом идемпотентности
02

Управление услугами

Управляйте активными услугами без обращения в поддержку, если запрошенное действие поддерживается тарифом.

  • Продлевать, приостанавливать, восстанавливать и отменять услуги
  • Заменять или добавлять IP и менять данные подключения
  • Управлять автопродлением, allowlist и дополнительными соединениями
03

Аналитика и диагностика

Используйте статистику аккаунта и услуг для анализа нагрузки, стабильности и направлений трафика.

  • Получать сводки использования и временные ряды
  • Проверять основные направления и категории ошибок
  • Получать диагностику и рекомендации по работе услуги
04

Платежи и поддержка

Связывайте работу с прокси с финансовыми процессами и обращениями в поддержку.

  • Получать счета и скачивать их в PDF
  • Создавать пополнение кошелька и проверять его статус
  • Создавать, читать, отвечать и закрывать тикеты
05

Доступ к прокси

Получайте настройки, которые приложения используют для подключения к купленным прокси.

  • Получать конфигурацию подключения ротационных прокси
  • Менять логин и пароль услуги
  • Управлять лимитами соединений для каждого IP в allowlist
06

События и аккаунт

Синхронизируйте внешние системы и проверяйте важные для безопасности данные аккаунта.

  • Настраивать вебхуки и обработку их доставки
  • Получать профиль, IP вызывающей стороны и историю входов
  • Создавать API-ключи с минимально необходимыми правами

Чего платформа не сделает

Автоматизация FineProxy намеренно ограничена. Доступ определяется правами ключа, тарифом услуги, живыми остатками и явными проверками безопасности.

Нет доступа вне выданных прав

Инструмент или endpoint не сможет прочитать или изменить ресурс, если у API-ключа нет необходимого разрешения.

Нет списаний без wallet:spend

Покупки, продления и платные обновления IP недоступны, если ключу не выдано финансовое разрешение.

Нет скрытых необратимых действий

Необратимые операции требуют явного флага подтверждения и не могут произойти как побочный эффект запроса на чтение.

Нет доступа к исходникам через MCP

MCP FineProxy управляет аккаунтом клиента. Для аудита скрипта вашему агенту разработки также нужен доступ к этому скрипту или репозиторию.

Нет гарантии отсутствующих IP

Страны и количество IP проверяются по живым остаткам. Автоматизация не сможет заказать отсутствующие адреса.

Нет партнёрского API без статуса

Партнёрская спецификация и отчёты доступны только аккаунтам с активным партнёрским статусом.

Подключите агента за несколько минут

Создайте для агента отдельный API-ключ в кабинете, выберите только необходимые права и добавьте MCP-конфигурацию в клиент. Настоящий ключ храните в секрете или переменной окружения.

mcp.json
{
  "mcpServers": {
    "fineproxy": {
      "url": "https://fineproxy.org/account_new/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer fb_YOUR_API_KEY"
      }
    }
  }
}

OpenAPI 3.1

Для разработки используйте актуальную спецификацию

В кабинете доступна клиентская спецификация OpenAPI 3.1 с примерами запросов, схемами ответов и фрагментами кода. Активным партнёрам также показывается отдельная партнёрская спецификация.

Открыть интерактивную документацию API

Выберите минимальный набор прав

Права на чтение и изменение разделены. Для изучения и аудита миграции начните с read-only, а запись и финансовые операции добавляйте только тому процессу, которому они действительно нужны.

customer:read

Чтение профиля клиента и данных аккаунта.

customer:write

Изменение информации клиента.

wallet:read

Просмотр баланса и данных кошелька.

wallet:deposit

Создание и отслеживание пополнений кошелька.

wallet:spend

Разрешение автоматизации тратить средства кошелька.

services:read

Просмотр услуг, настроек прокси и их состояния.

services:write

Создание и изменение услуг и дополнений.

tickets:read

Чтение тикетов поддержки и переписки.

tickets:write

Создание тикетов, ответы, изменение и закрытие.

catalog:read

Просмотр продуктов, опций, стран и текущих остатков.

usage:read

Чтение статистики использования и диагностики.

webhooks

Создание и управление подписками на вебхуки.

Безопасные настройки, которые стоит сохранить

  • Создавайте отдельный API-ключ для каждого приложения или агента, чтобы его можно было отозвать независимо.
  • Начинайте аудит с прав только на чтение. Добавляйте services:write или wallet:spend после проверки предложенного плана.
  • Храните ключи в переменных окружения или менеджере секретов, а не в исходниках, prompts, скриншотах и сохранённой MCP-конфигурации.
  • При покупке передавайте ожидаемую сумму из расчёта. Если цена изменилась, операция будет отклонена без неожиданного списания.
  • При повторе финансового запроса после таймаута используйте тот же ключ идемпотентности, чтобы операция не оплатилась дважды.
  • Проверьте подписи вебхуков и историю доставки, прежде чем использовать события в критически важном процессе.

Сначала получите видимость, затем выдавайте управление

Аудит только на чтение покажет, возможна ли миграция, без доступа к финансам и изменениям. После согласования плана создайте узко ограниченный производственный ключ и реализуйте интеграцию по актуальной спецификации OpenAPI.