Chiavi API
Le applicazioni che utilizzano un'API anziché l'interfaccia utente non possono effettuare l'accesso come utente. Ogni richiesta include invece il valore di una chiave API, che identifica l'account a cui appartiene la richiesta. Poiché la chiave contiene l'identificativo del Suo account, non è necessario specificare un parametro relativo all'account o al tenant nelle richieste.
È possibile definire fino a dieci chiavi per il proprio account. Molte organizzazioni creano una chiave per ciascuna applicazione che recupera dati, in modo che una chiave possa essere sostituita o eliminata senza interrompere il funzionamento delle altre applicazioni. Ogni chiave è dotata di un nome, una descrizione e una data di scadenza.
Il valore di una chiave viene visualizzato una sola volta, nel momento in cui la si crea o la si ruota. Account Administration non memorizza il valore in un formato che ne consenta la successiva visualizzazione; pertanto, è necessario copiarlo e conservarlo in modo sicuro nel momento in cui viene mostrato. Se un valore viene perso, è necessario ruotare la chiave per generarne uno nuovo. Chiunque disponga di tale valore può inviare richieste a nome del Suo account; pertanto, protegga le chiavi con la stessa cura con cui protegge una password. Le chiavi non sono limitate a stampanti specifiche.
Le chiavi vengono gestite nella scheda Chiavi API. È possibile modificare il nome, la descrizione o la data di scadenza di una chiave; effettuare la rotazione di una chiave per sostituirne il valore mantenendo la sua identità; oppure eliminare una chiave per revocarne immediatamente l'accesso.
In RICOH TotalFlow Cloud, le chiavi API vengono utilizzate con l'API di esportazione dei dati, che recupera le informazioni relative alle stampanti, ai lavori e allo stato delle stampanti raccolte da RICOH Predictive Insight. Il numero di richieste API che il Suo account può effettuare, considerando tutte le chiavi API, è determinato dal Suo abbonamento. Ogni abbonamento stabilisce un limite massimo per il numero di richieste API consentite in un periodo di 30 giorni consecutivi. Se si supera il numero di chiamate previsto dal proprio abbonamento, non verrà accettata alcuna richiesta fino a quando il totale delle richieste degli ultimi 30 giorni non scenderà al di sotto del limite previsto dall’abbonamento. Per verificare il numero di chiamate incluse nel Suo abbonamento e quante ne ha effettuate negli ultimi 30 giorni, consulti la pagina Chiavi API. Se dovesse riscontrare la necessità di una maggiore capacità per le richieste API, si rivolga al Suo rappresentante Ricoh per informazioni sull’aggiornamento del Suo abbonamento.