Как использовать API FlipLink для интеграций

Если вы управляете десятками (или сотнями) флипбуков, делать всё вручную через панель управления быстро надоедает. Вот для чего существует API FlipLink — он позволяет программно создавать флипбуки, управлять публикациями, получать аналитику и встраивать FlipLink в существующие инструменты и процессы.

Независимо от того, являетесь ли вы разработчиком, создающим кастомную интеграцию, или руководителем команды, стремящимся автоматизировать рутинные задачи, — это руководство расскажет, что умеет API и как с ним начать работу.

Что позволяет делать API FlipLink

REST API FlipLink даёт вам программный доступ к тем же возможностям, что и панель управления. Вместо того чтобы нажимать кнопки в интерфейсе, вы отправляете HTTP-запросы и получаете обратно структурированные JSON-ответы.

Вот что можно сделать:

• Создавать флипбуки и документы из PDF-файлов, не открывая панель управления
• Обновлять настройки публикаций — заголовки, описания, формы сбора лидов и права доступа
• Получать аналитику — просмотры, уникальных посетителей, среднее время на странице и другое
• Управлять публикациями пакетно — архивировать, удалять или обновлять десятки флипбуков одним скриптом
• Запускать процессы на основе событий, таких как захваченные новые лиды или достигнутые пороги просмотров

Полный обзор программных функций смотрите на странице «Доступ к API».

Получение API-ключа

Перед выполнением любых вызовов API вам нужен ключ. Вот как его получить:

1. Войдите в панель управления FlipLink на go.fliplink.me
2. Перейдите в Настройки → API
3. Нажмите Создать API-ключ
4. Скопируйте ключ и храните его надёжно — обращайтесь с ним как с паролем

Ваш API-ключ аутентифицирует каждый запрос. Включайте его в заголовок Authorization:

Authorization: Bearer YOUR_API_KEY

Важно: Никогда не раскрывайте API-ключ в клиентском коде или публичных репозиториях. Храните его на стороне сервера или в переменных окружения.

Распространённые сценарии использования API

Пакетное создание флипбуков

Есть папка с 50 каталогами продукции, которые нужно превратить в флипбуки? Вместо загрузки по одному напишите скрипт, который перебирает ваши PDF и обращается к эндпоинту создания для каждого. Объедините это с «Пакетными операциями» для максимальной эффективности.

Вывод аналитики в собственную панель управления

Если вы отслеживаете маркетинговую эффективность в централизованном инструменте — кастомной панели управления, Google Sheets или BI-платформе — вы можете получать данные о просмотрах и вовлечённости FlipLink через API и консолидировать их со своими другими метриками.

Управление публикациями в масштабе

Нужно обновить брендинг во всех флипбуках после ребрендинга? Или архивировать каталоги за прошлый квартал? API позволяет пакетно выполнять такие обновления, не кликая по каждой публикации вручную.

Подключение к платформам автоматизации

Объедините API с такими инструментами, как Zapier, Pabbly или Make, чтобы создавать процессы без кода. Например, автоматически создавать флипбук каждый раз, когда новый PDF появляется в определённой папке Google Drive. Пошаговые инструкции — в нашем руководстве по подключению FlipLink к платформам автоматизации, или изучите функцию «Автоматизация и интеграции».

Пример: создание флипбука через API

Вот базовый пример с использованием curl для создания нового флипбука из PDF:

curl -X POST https://api.fliplink.me/v1/publications \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@product-catalog.pdf" \
  -F "title=Spring Product Catalog" \
  -F "type=flipbook" \
  -F "visibility=public"

API возвращает JSON-ответ с идентификатором публикации, кодом для встраивания и ссылкой для публикации — всё необходимое для немедленного распространения флипбука.

То же самое можно сделать на Python, Node.js или любом другом языке с поддержкой HTTP-запросов. API стандартный REST, поэтому он работает с любым стеком, который вы уже используете.

Доступные эндпоинты API

Все эндпоинты возвращают JSON и следуют стандартным HTTP-кодам состояния. Действуют ограничения по частоте запросов — актуальные пороги смотрите в документации API в вашей панели управления.

Когда использовать API, а когда панель управления

Не всё требует вызова API. Вот простой фреймворк принятия решений:

• Используйте панель управления, когда создаёте один флипбук, настраиваете дизайн визуально или просто изучаете аналитику
• Используйте API, когда работаете более чем с пятью публикациями одновременно, интегрируете с другими системами или автоматизируете повторяющиеся задачи
• Используйте платформы автоматизации (Zapier/Make/Pabbly), когда хотите возможности API без написания кода

Для команд, управляющих каталогами продукции или любым контентом, который регулярно обновляется, API окупает себя сэкономленным временем уже после первого пакетного запуска.

Начните разработку

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

Готовы начать? Создайте бесплатный аккаунт FlipLink и сгенерируйте API-ключ уже сегодня. Ознакомьтесь с нашими тарифами, чтобы узнать, что включено в доступ к API.