Contrôles et canaux de partage

Ce que tu peux faire

Deux endpoints contrôlent la façon dont les boutons de partage d'un flipbook apparaissent dans le lecteur :

• Interrupteur principal — active ou désactive l'ensemble des boutons de partage en un seul appel.
• Activation par canal — décide précisément quels canaux sociaux (Facebook, X, LinkedIn, WhatsApp, e-mail et d'autres) s'affichent dans le menu de partage du lecteur.

Les deux s'appliquent à un seul flipbook, identifié par son {flipbookId}.

Avant de commencer

Il te faut :

• Une clé d'API — envoyée dans l'en-tête X-Api-Key, ou sous la forme Authorization: Bearer YOUR_API_KEY.
• Le {flipbookId} — l'ID numérique du flipbook, renvoyé par create-by-file / create-by-url (dans ID) ou par list.
• Toutes les requêtes sont adressées à l'URL de base https://go.fliplink.me.

Les deux endpoints attendent un corps form-urlencoded (pas JSON). La valeur de chaque champ est un booléen envoyé sous forme de texte (true / false).

Activer ou désactiver les boutons de partage

PUT /api/set-share-master/{flipbookId} est l'interrupteur principal marche/arrêt des boutons de partage dans le lecteur.

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

Réponse :

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

Activer chaque canal de partage individuellement

PUT /api/set-share-channels/{flipbookId} active individuellement chaque canal de partage social (Facebook, X, LinkedIn, WhatsApp, e-mail, etc.) dans le menu de partage du lecteur. Envoie true pour afficher un canal ou false pour le masquer.

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'

Réponse :

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

Erreurs possibles

• Clé d'API manquante ou invalide → HTTP 401. Renvoie une simple page HTML « Unauthorized » — sans corps JSON. Vérifie que l'en-tête X-Api-Key (ou Authorization: Bearer) est présent et correct.
• ID d'élément introuvable ou non rattaché à ta clé → HTTP 200 avec Message = Item not found.
• Champ de corps inconnu ou mal orthographié → HTTP 200 avec Message = Unknown field(s) '…'. Expected: ….