Accesso diretto alle immagini e agli allegati

E” possibile accedere direttamente a immagini e allegati di un database usando un approccio REST, ossia tramite un url opportunamente formattato.

Accesso con session id

Per accedere alle immagini:

/binary/<sid>/<tablename>/<id>/<type>[?<name>]

Dove sid è la session id riportata dalla chiamata JSON-RPC open_database, tablename è il nome della tabella da cui si vuole estrarre un’immagine (ad esempio EB_Articoli), id è il valore della chiave primaria del record per cui estrarre l’immagine, e type identifica quale tipo di immagine ottenere (può assumere i valori thumbnail per la miniatura, normal per l’immagine intera, web per quella web o image per le immagini aggiuntive; se non specificato, è assunto il tipo web). Se type è image, name sarà il nome dell’immagine che si vuole ottenere, specificato come la parte query string url-encoded dell’url.

Per accedere agli allegati:

/binary/<sid>/<tablename>/<id>/<filename>

Dove i parametri sono gli stessi di prima, con la sola eccezione che type è sostituito dal nome del file allegato che si vuole ottenere. Per una lista di nomi file disponibili per un dato record, si può usare la chiamata JSON-RPC list_binaries.

Accesso con token di autenticazione

E” possibile fare a meno della session id ed accedere alle immagini e agli allegati direttamente con un url del tipo:

/binary/<tablename>/<id>/...

Per usare questa modalità però è necessario essere in possesso di un token di accesso web precedentemente creato dalla configurazione del database in Konga, alla voce Token accesso web. Questo token va usato in un header HTTP apportunamente predisposto nella forma:

Authorization: Bearer <token>

Nota

Per ragioni di sicurezza l’accesso tramite web token funziona solo se i webservice sono stati attivati in modalità SSL.