Een flipbook beveiligen met een wachtwoord

Toegangsbeheer

Schakel wachtwoordbeveiliging voor een flipbook in of uit en pas het wachtwoordscherm aan — de titel, de invoerplaceholder en de knop — met één API-aanroep.

API's die in deze discussie worden gebruikt

Iets onjuist of verouderd in deze gids?

Wat je kunt doen

Wachtwoordbeveiliging zet een gate voor een flipbook: kijkers moeten het juiste wachtwoord invoeren voordat de content laadt. Met één API-aanroep kun je:

  • Beveiliging inschakelen en het toegangswachtwoord instellen.
  • Beveiliging weer uitschakelen.
  • Het wachtwoordscherm aanpassen — de kop, de invoerplaceholder en het knoplabel.

Voordat je begint

Je hebt nodig:

  • Een API-sleutel — meegestuurd als de X-Api-Key-header op elk verzoek.
  • De flipbookId — de numerieke id die je terugkrijgt wanneer je een flipbook aanmaakt (als ID) of via de list-endpoints.
  • Verzoeken gaan naar de basis-URL https://go.fliplink.me.

De body is form-urlencoded (geen JSON).

Parameters

Stuur deze als urlencoded velden naar PUT /api/set-password-access/{flipbookId}:

VeldTypeWat het doet
IsPasswordProtectedbooleantrue schakelt de wachtwoordgate in; false schakelt hem uit
PasswordtextHet toegangswachtwoord dat kijkers moeten invoeren
PwdTitletextKop die op het wachtwoordscherm wordt getoond (optioneel)
PwdPlaceholdertextPlaceholdertekst in het wachtwoordveld (optioneel)
PwdButtontextLabel op de verzendknop (optioneel)

Wachtwoordbeveiliging inschakelen

Zet IsPasswordProtected=true en geef het Password op. De drie Pwd*-velden zijn optioneel — voeg ze toe om aan te passen wat de kijker ziet.

curl -X PUT 'https://go.fliplink.me/api/set-password-access/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsPasswordProtected=true' \
  --data-urlencode 'Password=spring-2026' \
  --data-urlencode 'PwdTitle=Enter the access code' \
  --data-urlencode 'PwdPlaceholder=Access code' \
  --data-urlencode 'PwdButton=View document'

Response:

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

Wachtwoordbeveiliging uitschakelen

Zet IsPasswordProtected=false. De andere velden mag je leeg laten.

curl -X PUT 'https://go.fliplink.me/api/set-password-access/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsPasswordProtected=false' \
  --data-urlencode 'Password=' \
  --data-urlencode 'PwdTitle=' \
  --data-urlencode 'PwdPlaceholder=' \
  --data-urlencode 'PwdButton='

Response:

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

Het wachtwoordscherm aanpassen

Met de velden PwdTitle, PwdPlaceholder en PwdButton stem je de gate af op je publiek — noem het bijvoorbeeld een "toegangscode" voor een klantportaal, of laat het aansluiten op de toon van je merk. Ze zijn optioneel; laat ze weg (of stuur ze leeg) om de standaardwaarden te gebruiken.

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 aanwezig en correct is.
  • Onbekende flipbookId (of een die niet bij je sleutel hoort) → HTTP 200 met { "Result": "ERROR", "Message": "Item not found" }.
  • Verkeerd gespeld body-veld → HTTP 200 met { "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }. Controleer de veldnamen nog eens aan de hand van de tabel hierboven.

Opmerkingen

  • Deel het wachtwoord via een apart kanaal. Stuur de flipbooklink en het wachtwoord via verschillende kanalen — een wachtwoord in dezelfde e-mail als de link biedt weinig bescherming.
  • Wachtwoordbeveiliging is één laag. Het regelt de toegang, niet wie de kijker is. Om toegang te beperken tot bepaalde personen, combineer je het met een e-mailtoegangslijst; om toegang in de tijd te beperken, koppel je het aan het verlopen van de link.

Gerelateerde discussies