Teilen-Steuerung und Kanäle

Was du tun kannst

Zwei Endpunkte steuern, wie die Teilen-Buttons eines Flipbooks im Viewer erscheinen:

• Hauptschalter – schalte den gesamten Satz an Teilen-Buttons mit einem Aufruf ein oder aus.
• Umschalter pro Kanal – entscheide genau, welche sozialen Kanäle (Facebook, X, LinkedIn, WhatsApp, E-Mail und andere) im Teilen-Menü des Viewers erscheinen.

Beide gelten für ein einzelnes Flipbook, identifiziert über seine {flipbookId}.

Bevor du loslegst

Du brauchst:

• Einen API-Schlüssel – wird als X-Api-Key-Header oder als Authorization: Bearer YOUR_API_KEY gesendet.
• Die {flipbookId} – die numerische ID des Flipbooks, zurückgegeben von create-by-file / create-by-url (als ID) oder von list.
• Alle Anfragen gehen an die Basis-URL https://go.fliplink.me.

Beide Endpunkte nehmen einen form-urlencoded Body entgegen (kein JSON). Jeder Feldwert ist ein boolean, der als Text gesendet wird (true / false).

Die Teilen-Buttons ein- oder ausschalten

PUT /api/set-share-master/{flipbookId} ist der Haupt-Ein/Aus-Schalter für die Teilen-Buttons im Viewer.

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

Antwort:

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

Einzelne Teilen-Kanäle umschalten

PUT /api/set-share-channels/{flipbookId} schaltet jeden sozialen Teilen-Kanal (Facebook, X, LinkedIn, WhatsApp, E-Mail usw.) einzeln im Teilen-Menü des Viewers um. Sende true, um einen Kanal anzuzeigen, oder false, um ihn auszublenden.

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'

Antwort:

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

Mögliche Fehler

• Fehlender oder ungültiger API-Schlüssel → HTTP 401. Das gibt eine reine Unauthorized-HTML-Seite zurück – es gibt keinen JSON-Body. Prüfe, ob der X-Api-Key-Header (oder Authorization: Bearer) vorhanden und korrekt ist.
• Item-ID nicht gefunden oder nicht im Besitz deines Schlüssels → HTTP 200 mit Message = Item not found.
• Unbekanntes oder falsch geschriebenes Body-Feld → HTTP 200 mit Message = Unknown field(s) '…'. Expected: ….