Deelknoppen en -kanalen instellen

Wat je kunt doen

Twee endpoints bepalen hoe de deelknoppen van een flipbook in de viewer verschijnen:

• Hoofdschakelaar — zet de hele set deelknoppen in één aanroep aan of uit.
• Toggles per kanaal — bepaal precies welke social kanalen (Facebook, X, LinkedIn, WhatsApp, e-mail en andere) in het deelmenu van de viewer verschijnen.

Beide gelden voor één flipbook, geïdentificeerd door zijn {flipbookId}.

Voordat je begint

Je hebt nodig:

• Een API-sleutel — meegestuurd als de X-Api-Key-header, of als Authorization: Bearer YOUR_API_KEY.
• De {flipbookId} — de numerieke ID van de flipbook, teruggegeven door create-by-file / create-by-url (als ID) of door list.
• Alle verzoeken gaan naar de basis-URL https://go.fliplink.me.

Beide endpoints nemen een form-urlencoded body (geen JSON). Elke veldwaarde is een boolean die als tekst wordt meegestuurd (true / false).

De deelknoppen aan- of uitzetten

PUT /api/set-share-master/{flipbookId} is de hoofdschakelaar aan/uit voor de deelknoppen in de viewer.

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

Response:

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

Afzonderlijke deelkanalen schakelen

PUT /api/set-share-channels/{flipbookId} schakelt elk social deelkanaal (Facebook, X, LinkedIn, WhatsApp, e-mail enz.) afzonderlijk in het deelmenu van de viewer. Stuur true om een kanaal te tonen of false om het te verbergen.

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'

Response:

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

Mogelijke fouten

• Ontbrekende of ongeldige API-sleutel → HTTP 401. Dit geeft een kale Unauthorized-HTML-pagina terug — er is geen JSON-body. Controleer of de X-Api-Key-header (of Authorization: Bearer) aanwezig en correct is.
• Item-ID niet gevonden of niet in eigendom van je sleutel → HTTP 200 met Message = Item not found.
• Onbekend of verkeerd gespeld body-veld → HTTP 200 met Message = Unknown field(s) '…'. Expected: ….