Управление кнопками и каналами общего доступа

Общий доступ

Включайте или выключайте кнопки «Поделиться» в просмотрщике одним главным переключателем и переключайте каждый социальный канал — Facebook, X, LinkedIn, WhatsApp, email и другие — по отдельности.

API, используемые в этом обсуждении

Что-то в этом руководстве неточно или устарело?

Что можно сделать

Два эндпоинта управляют тем, как кнопки «Поделиться» флипбука отображаются в просмотрщике:

Главный переключатель — включает или выключает весь набор кнопок «Поделиться» одним вызовом.
Переключатели по каналам — решают, какие именно социальные каналы (Facebook, X, LinkedIn, WhatsApp, email и другие) показываются в меню «Поделиться» просмотрщика.

Оба применяются к одному флипбуку, определяемому по его {flipbookId}.

Перед началом

Понадобится:

API-ключ — передаётся в заголовке X-Api-Key или как Authorization: Bearer YOUR_API_KEY.
{flipbookId} — числовой ID флипбука, возвращаемый из create-by-file / create-by-url (как ID) или из list.
Все запросы идут на базовый URL https://go.fliplink.me.

Оба эндпоинта принимают тело в формате form-urlencoded (не JSON). Значение каждого поля — булево, передаваемое текстом (true / false).

Включение или выключение кнопок «Поделиться»

PUT /api/set-share-master/{flipbookId} — это главный переключатель кнопок «Поделиться» в просмотрщике.

curl -X PUT 'https://go.fliplink.me/api/set-share-master/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsShareButtons=false'

Ответ:

{
  "Result": "OK",
  "Message": "Updated successfully"
}

Переключение отдельных социальных каналов

PUT /api/set-share-channels/{flipbookId} переключает каждый социальный канал (Facebook, X, LinkedIn, WhatsApp, email и т. д.) по отдельности в меню «Поделиться» просмотрщика. Передайте true, чтобы показать канал, или false, чтобы скрыть его.

curl -X PUT 'https://go.fliplink.me/api/set-share-channels/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsShareFacebook=true' \
  --data-urlencode 'IsShareTwitter=true' \
  --data-urlencode 'IsShareWhatsApp=true' \
  --data-urlencode 'IsShareTelegram=false' \
  --data-urlencode 'IsShareLinkedIn=true' \
  --data-urlencode 'IsSharePinterest=false' \
  --data-urlencode 'IsShareReddit=false' \
  --data-urlencode 'IsShareTumblr=false' \
  --data-urlencode 'IsShareMessenger=false' \
  --data-urlencode 'IsShareEmail=true' \
  --data-urlencode 'IsShareLine=false' \
  --data-urlencode 'IsShareWeChat=false' \
  --data-urlencode 'IsShareInstagram=false' \
  --data-urlencode 'IsShareFlipboard=false' \
  --data-urlencode 'IsShareGeneral=true'

Ответ:

{
  "Result": "OK",
  "Message": "Updated successfully"
}

Возможные ошибки

Отсутствующий или неверный API-ключ → HTTP 401. Возвращается обычная HTML-страница Unauthorized — тела JSON нет. Проверьте, что заголовок X-Api-Key (или Authorization: Bearer) присутствует и указан верно.
ID элемента не найден или не принадлежит вашему ключу → HTTP 200 с Message = Item not found.
Неизвестное поле тела запроса или опечатка в нём → HTTP 200 с Message = Unknown field(s) '…'. Expected: ….