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

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

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

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

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

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

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

Полный обзор программных функций смотри на странице функции «Доступ к API» — а точные эндпоинты, параметры и живые примеры ищи в справочнике API.

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

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

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

Твой API-ключ аутентифицирует каждый запрос. Передавай его в заголовке X-Api-Key:

X-Api-Key: YOUR_API_KEY

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

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

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

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

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

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

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

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

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

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

🚀

Попробуйте FlipLink бесплатно

Преобразуйте PDF за секунды. Без регистрации и кредитной карты — просто загрузите файл.

Drop your PDF here or click to browse

Макс. 40 МБ

На платных тарифах от $39 лимит вырастает до 150 MB.

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

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

curl -X POST 'https://go.fliplink.me/api/create-by-file' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -F 'File=@product-catalog.pdf' \
  -F 'Name=Spring Product Catalog' \
  -F 'Title=Spring Product Catalog' \
  -F 'DocType=Flipbook'

API возвращает JSON-ответ — {"Result":"OK","ID":"90001","URL":"https://go.fliplink.me/view/<slug>", ...} — с ID публикации и ссылкой для общего доступа, которые нужны тебе, чтобы немедленно распространить флипбук. PDF уже размещён онлайн? Подставь POST /api/create-by-url и передай FileURL вместо File.

То же самое можно сделать на Python, Node.js или любом другом языке с поддержкой HTTP. API стандартный REST с form-urlencoded (или multipart) телами запросов, поэтому он работает с любым стеком, который ты уже используешь. Запомни одну вещь: ошибки приложения возвращаются как HTTP 200 с Result: "ERROR" (только ошибки аутентификации возвращают 401), поэтому ветвись по полю Result.

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

Это лишь небольшая часть — полный каталог из 80+ эндпоинтов, каждый с параметрами и живой консолью Try-It, находится в справочнике API.

Все эндпоинты возвращают JSON. Ограничение скорости — 300 запросов в минуту на каждый API-ключ. Каждый эндпоинт, его параметры, модель ошибок и пути зависимостей смотри в справочнике API.

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

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

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

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

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

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

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