Gestire l'elenco email consentite di un flipbook

Cosa puoi fare

Quando un flipbook è protetto tramite email, solo gli indirizzi presenti nel suo elenco consentiti possono aprirlo. L'API ti offre quattro modi per gestire quell'elenco senza mai toccare la dashboard:

• Leggere l'elenco attuale, così non devi tenerne traccia da solo.
• Aggiungere uno o più indirizzi (senza toccare quelli già presenti).
• Rimuovere indirizzi specifici.
• Sostituire l'intero elenco in un'unica chiamata.

Questa guida illustra ciascuna operazione, la forma esatta della richiesta, le risposte che ottieni e l'unico tranello in cui molti cadono (la differenza tra aggiungere e sostituire).

Prima di iniziare

Ti serviranno:

• Una chiave API — inviata come header X-Api-Key in ogni richiesta. (La tua chiave si trova nella pagina API del tuo account.)
• Il flipbookId di un flipbook protetto tramite email. L'elenco consentiti regola l'accesso dei lettori sui flipbook protetti tramite email.
• Tutte le richieste vanno all'URL di base https://go.fliplink.me.

Il campo EmailsAllowed nelle richieste di scrittura è form-urlencoded (non JSON) e separato da punto e virgola (alice@corp.com;bob@corp.com). Le virgole sono accettate e convertite automaticamente in punti e virgola.

I quattro endpoint in sintesi

Leggere l'elenco attuale

Parti sempre da qui — leggi l'elenco così conosci il suo stato esatto prima di cambiare qualcosa.

curl -X GET 'https://go.fliplink.me/api/get-email-allow-list/96464' \
  -H 'X-Api-Key: YOUR_API_KEY'

Risposta:

{ "Result": "OK", "EmailsAllowed": ["alice@corp.com", "bob@corp.com"], "Count": 2 }

EmailsAllowed torna come un array JSON pulito (non una stringa separata da punti e virgola), e Count è la sua lunghezza.

Aggiungere indirizzi (senza cancellare il resto)

Per concedere l'accesso a nuove persone mantenendo tutti quelli già nell'elenco, usa Add. È additivo — non rimuove nessuno.

curl -X POST 'https://go.fliplink.me/api/add-email-allow-list/96464' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'EmailsAllowed=carol@corp.com;dan@corp.com'

Risposta (l'elenco completo e aggiornato):

{ "Result": "OK", "EmailsAllowed": ["alice@corp.com", "bob@corp.com", "carol@corp.com", "dan@corp.com"], "Count": 4 }

Rimuovere indirizzi specifici

Per revocare l'accesso a persone indicate, usa Delete. Vengono rimossi solo gli indirizzi che elenchi; tutti gli altri restano.

curl -X DELETE 'https://go.fliplink.me/api/delete-email-allow-list/96464' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'EmailsAllowed=carol@corp.com'

Risposta:

{ "Result": "OK", "EmailsAllowed": ["alice@corp.com", "bob@corp.com", "dan@corp.com"], "Count": 3 }

Sostituire l'intero elenco ⚠️

Set sovrascrive tutto l'elenco consentiti esattamente con gli indirizzi che invii. Ecco il tranello: inviare un solo indirizzo cancella tutti gli altri.

# Questo NON aggiunge una persona — rende l'elenco composto SOLO da questa persona.
curl -X PUT 'https://go.fliplink.me/api/set-email-allow-list/96464' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'EmailsAllowed=alice@corp.com'

Dopo questa chiamata, alice@corp.com è l'unico indirizzo che può vedere il flipbook. Usa Set solo quando vuoi davvero definire l'elenco completo da zero (per esempio, per inizializzare un flipbook nuovo). Per le modifiche quotidiane del tipo "concedi a questa persona / revoca a quella", usa invece Add e Delete.

Per svuotare completamente l'elenco, invia un valore vuoto:

curl -X PUT 'https://go.fliplink.me/api/set-email-allow-list/96464' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'EmailsAllowed='

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 sia presente e corretto.
• flipbookId sconosciuto (o non di proprietà della tua chiave) → HTTP 200 con { "Result": "ERROR", "Message": "Item not found" }.

Una regola pratica: Result: "OK" significa che la modifica è stata applicata; Result: "ERROR" significa che non lo è stata — leggi il Message per capirne il motivo.

Pattern consigliato

Per modifiche sicure e prevedibili:

1. Esegui GET dell'elenco attuale.
2. Decidi chi aggiungere o rimuovere.
3. Usa Add / Delete per modifiche granulari (non toccano mai il resto dell'elenco).
4. Riserva Set ai casi in cui vuoi davvero sostituire tutto l'elenco in una volta.
5. Esegui di nuovo GET per confermare lo stato finale.

Questo ciclo "leggi → modifica → rileggi" fa sì che tu non debba mai tenere traccia dell'elenco nel tuo sistema, e che tu non cancelli mai per sbaglio degli accessi usando Set quando intendevi Add.