Controlli e canali di condivisione

Cosa puoi fare

Due endpoint controllano come compaiono i pulsanti di condivisione di un flipbook nel viewer:

• Interruttore principale — attiva o disattiva l'intero gruppo di pulsanti di condivisione in una chiamata.
• Toggle per canale — decidi esattamente quali canali social (Facebook, X, LinkedIn, WhatsApp, email e altri) compaiono nel menu di condivisione del viewer.

Entrambi si applicano a un singolo flipbook, identificato dal suo {flipbookId}.

Prima di iniziare

Ti serviranno:

• Una chiave API — inviata come header X-Api-Key, o come Authorization: Bearer YOUR_API_KEY.
• Il {flipbookId} — l'ID numerico del flipbook, restituito da create-by-file / create-by-url (come ID) o da list.
• Tutte le richieste vanno all'URL di base https://go.fliplink.me.

Entrambi gli endpoint accettano un body form-urlencoded (non JSON). Il valore di ogni campo è un boolean inviato come testo (true / false).

Attivare o disattivare i pulsanti di condivisione

PUT /api/set-share-master/{flipbookId} è l'interruttore principale di attivazione/disattivazione dei pulsanti di condivisione nel viewer.

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

Risposta:

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

Attivare/disattivare i singoli canali di condivisione

PUT /api/set-share-channels/{flipbookId} attiva/disattiva singolarmente ogni canale social di condivisione (Facebook, X, LinkedIn, WhatsApp, email, ecc.) nel menu di condivisione del viewer. Invia true per mostrare un canale o false per nasconderlo.

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'

Risposta:

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

Errori possibili

• Chiave API mancante o non valida → HTTP 401. Restituisce una semplice pagina HTML di Unauthorized — non c'è alcun body JSON. Controlla che l'header X-Api-Key (o Authorization: Bearer) sia presente e corretto.
• ID dell'elemento non trovato o non di proprietà della tua chiave → HTTP 200 con Message = Item not found.
• Campo del body sconosciuto o scritto male → HTTP 200 con Message = Unknown field(s) '…'. Expected: ….