.. _ws_binary_access: 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////[?] Dove *sid* è la *session id* riportata dalla chiamata JSON-RPC :ref:`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//// 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///... 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 .. note:: Per ragioni di sicurezza l'accesso tramite web token funziona solo se i webservice sono stati attivati in modalità SSL.