ОсобенностиЦеныБлог

Платформа дорожной разведки

Продукт

  • Особенности
  • Цены
  • Документация

Компания

  • О
  • Блог
  • Контакт

Юридический

  • Конфиденциальность
  • Условия

© 2026 Magicgate. Все права защищены.

Продукт10 февраля 2026 г.4 минута чтения

API Mode против Direct Mode: выбор правильной интеграции

Два способа интегрировать фильтрацию трафика в ваш рабочий процесс. Мы разберем, когда использовать каждый подход, и связанные с этим компромиссы.

При настройке решения для фильтрации трафика одно из первых решений, которое вы примете, — это интегрировать его в существующий рабочий процесс. Большинство платформ предлагают два подхода: API, который вы вызываете из собственного кода, или режим прямого/перенаправления, который обрабатывает все автоматически. Каждый из них имеет определенные преимущества.

API Mode: Полный доступ для разработчиков

API Mode работает через простой запрос HTTP. Вы отправляете POST-запрос с атрибутами посетителя (IP-адрес, пользовательский агент, заголовки и т. д.) и получаете ответ JSON с вердиктом: «предложение» для легитимного трафика или «белый» для фильтрованного трафика. Главное преимущество API Mode — гибкость. Вы точно контролируете, как используется вердикт — перенаправление на разные страницы, предоставление различного встроенного контента, регистрация дополнительных данных или интеграция с существующей серверной логикой. API Mode идеально подходит для: - Пользовательские целевые страницы PHP, Node.js или Python. - Сложная логика маршрутизации с множеством вариантов предложений. - Интеграция с существующими платформами аналитики или отслеживания. - Рендеринг на стороне сервера, где вам нужен вердикт перед генерацией страницы.

Direct Mode: интеграция с нулевым кодом

Direct Mode устраняет необходимость в каких-либо изменениях кода. Вы направляете свой домен на сервис фильтрации, настраиваете URL страницы оффера и белой страницы, а платформа берет на себя всё: оценку посетителей, решения о маршрутизации и перенаправление трафика. Direct Mode поддерживает несколько методов маршрутизации: - 302 Redirect: браузер посетителя перенаправляется на URL страницы оффера или белой страницы. Это простой и широко совместимый вариант. - Reverse Proxy: сервис фильтрации получает и отдает контент страницы оффера или белой страницы под вашим доменом. Посетитель никогда не видит фактический целевой URL. - Iframe Embed: контент загружается в iframe под вашим доменом. Это полезно, если вам нужно сохранить единый URL. Direct Mode идеально подходит маркетологам, которым нужно готовое решение.

Сравнение производительности

В обоих режимах время вынесения вердикта может достигать менее 10 мс, если базовый механизм работает быстро. Разница заключается в общем жизненном цикле запроса: - API Mode добавляет один запрос HTTP к вашей серверной логике. Если ваш сервер находится рядом со службой фильтрации, это добавляет 5-20 мс. - Direct Mode требует, чтобы посетитель сначала обратился к службе фильтрации, а затем был перенаправлен. Это добавляет полный обход, но само перенаправление обрабатывается на уровне HTTP, поэтому оно выполняется быстро. На практике оба подхода незаметны для посетителей. Выбор должен основываться на ваших технических требованиях, а не на проблемах производительности.

Что выбрать?

Выберите API Mode, если у вас есть ресурсы для разработки, вам нужна собственная логика маршрутизации или вы хотите интегрировать фильтрацию в существующую базу кода. Выберите Direct Mode, если вам нужна самая быстрая установка, у вас нет серверного кода или вы предпочитаете управляемое решение, в котором вся маршрутизация выполняется платформой. Многие пользователи начинают с Direct Mode из-за его простоты и переходят на API Mode позже, когда им понадобится больше контроля. Лучшие платформы поддерживают оба режима с помощью одного и того же механизма фильтрации, поэтому вы получаете одинаковую защиту независимо от метода интеграции.

Похожие статьи

Руководство

Что такое клоакинг и почему умные маркетологи его используют

Маскировка трафика — это метод, который показывает разный контент разным посетителям в зависимости от их атрибутов. Узнайте, как это работает и почему это важно для ваших кампаний.

Советы

5 основных фильтров, необходимых каждой кампании для блокировки трафика ботов

Не все фильтры одинаковы. Эти пять типов фильтров составляют основу любой эффективной настройки фильтрации трафика.