Organizzare i flipbook con cartelle e template

Cosa puoi fare

Questi tre endpoint ti permettono di tenere organizzati i tuoi flipbook senza toccare la dashboard:

• Elencare le tue cartelle, ognuna restituita come un nome e un GUID di cartella.
• Assegnare un flipbook a una cartella — le cartelle vengono create su richiesta, e inviare una cartella vuota rimuove il flipbook dalla sua cartella.
• Salvare un flipbook come template riutilizzabile, o rimuoverlo dai tuoi template.

Prima di iniziare

• Una chiave API — inviata come header X-Api-Key o come Authorization: Bearer YOUR_API_KEY in ogni richiesta.
• Tutte le richieste vanno all'URL di base https://go.fliplink.me.
• I due endpoint di scrittura (assign-to-folder e save-as-template) usano un parametro {flipbookId} nel percorso — l'ID numerico del flipbook, restituito da create-by-file / create-by-url (come ID) o da list.
• Questi endpoint di scrittura accettano un body form-urlencoded (non JSON).

Elencare le tue cartelle

GET /api/list-folders elenca le tue cartelle, ognuna come { Folder (nome), URL (un GUID di cartella) }. Le cartelle derivano dalle assegnazioni dei flipbook, quindi una cartella vuota non viene elencata.

curl -X GET 'https://go.fliplink.me/api/list-folders' \
  -H 'X-Api-Key: YOUR_API_KEY'

Risposta:

{
  "Result": "OK",
  "Items": [
    {
      "Folder": "Marketing",
      "URL": "00000000-0000-0000-0000-000000000001"
    },
    {
      "Folder": "Marketing/Q2",
      "URL": "00000000-0000-0000-0000-000000000002"
    }
  ]
}

Assegnare un flipbook a una cartella

PUT /api/assign-to-folder/{flipbookId} sposta il flipbook in una cartella. Le cartelle vengono create su richiesta — assegna a un nome di cartella che non esiste ancora e viene creata automaticamente (non c'è una chiamata separata per "creare una cartella"). I nomi delle cartelle possono contenere / (per esempio Marketing/Q2). Una cartella esiste solo finché contiene almeno un flipbook, quindi spostare fuori l'ultimo flipbook fa sparire la cartella da list-folders.

curl -X PUT 'https://go.fliplink.me/api/assign-to-folder/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'Folder=Marketing/Q2'

Risposta:

{
  "Result": "OK",
  "Message": "Folder updated successfully"
}

Per rimuovere il flipbook dalla sua cartella, invia un Folder vuoto:

curl -X PUT 'https://go.fliplink.me/api/assign-to-folder/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'Folder='

Salvare un flipbook come template

PUT /api/save-as-template/{flipbookId} contrassegna il flipbook come template riutilizzabile (Status=true) o lo rimuove dai template (Status=false). I template compaiono in list-templates e possono servire da base per nuovi flipbook. Status è predefinito a true se omesso.

curl -X PUT 'https://go.fliplink.me/api/save-as-template/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'Status=true'

Risposta:

{
  "Result": "OK",
  "Message": "Saved as template"
}

Errori possibili

• Chiave API mancante o non valida → HTTP 401. Restituisce una semplice pagina HTML di Unauthorized — non c'è alcun body JSON.
• ID dell'elemento non trovato o non di proprietà della tua chiave (assign-to-folder, save-as-template) → HTTP 200 con Message: "Item not found".
• Campo del body sconosciuto o scritto male (assign-to-folder, save-as-template) → HTTP 200 con Message: "Unknown field(s) '…'. Expected: …".

Note

• Il nome della cartella Folder che assegni è lo stesso valore che compare sotto Folder in list-folders, quindi puoi riutilizzare un nome di cartella esistente per aggiungervi altri flipbook.