Utilizzo dell'API di esportazione dei dati

Grazie all'API di esportazione dei dati, è possibile estrarre le informazioni raccolte da RICOH Predictive Insight per utilizzarle in altri processi e strumenti all'interno della propria organizzazione.

L'API di esportazione dei dati consente l'accesso programmatico alle informazioni relative alla stampante, alla cronologia dei lavori, ai dati sullo stato della stampante e agli eventi di intervento sulla stampante. Può utilizzarlo per alimentare strumenti di reporting, compilare dashboard, archiviare dati operativi o integrare i dati di RICOH Predictive Insight con altri sistemi presenti nel Suo ambiente.

In this section:

  1. API di esportazione dei dati
    L'API di esportazione dei dati è un'API REST che mette a disposizione quattro endpoint. È possibile utilizzare tali endpoint per scaricare informazioni relative alle proprie stampanti e ai processi da esse elaborati, nonché sugli stati operativi di tali stampanti nel corso del tempo e sugli eventi che hanno generato messaggi di avviso o di errore sulla stampante.
  2. Creazione e gestione delle chiavi API
    Una chiave API autorizza le richieste all'API di esportazione dei dati. È possibile creare e gestire le chiavi API in Account Administration e fornire la chiave quando si inviano richieste dalla pagina Esploratore API o dalle proprie applicazioni.
  3. Provare l'API di esportazione dei dati
    Segua questa procedura per una breve introduzione all'API, utilizzando la pagina della documentazione interattiva come guida.
  4. Date e ora: gestione nell'API di esportazione dei dati
    L'API di esportazione dei dati utilizza un unico modello coerente per la gestione di date e ore: ogni richiesta specifica un fuso orario IANA, ogni valore di data e ora viene interpretato in base a tale fuso orario e ogni valore di data e ora presente nella risposta viene formattato secondo lo stesso fuso orario. Utilizzi questa sezione per comprendere il funzionamento del modello ed evitare gli errori più comuni.
  5. Campi della risposta dell'API di esportazione dei dati
    Ogni endpoint dell'API di esportazione dei dati restituisce un array JSON di oggetti. Utilizzi le tabelle riportate in questa sezione per interpretare i campi presenti in ciascuna risposta.
  6. Esempi di richieste e risposte dell'API di esportazione dei dati
    Utilizzi gli esempi riportati in questa sezione come punto di partenza per la propria integrazione. Ciascun esempio illustra un URL di richiesta rappresentativo insieme al corpo della risposta restituita dall'API.
  7. Risoluzione dei problemi relativi all'API di esportazione dei dati
    Utilizzare questa sezione per interpretare le risposte di errore più comuni dell'API di esportazione dei dati e per individuare la causa più probabile e la soluzione per ciascuna di esse. Ogni risposta di errore include un code, un message e un statusCode numerico; il valore del code identifica la condizione specifica.

Related information:

Creazione e gestione delle chiavi API
Scheda Chiavi API
Chiavi API
Argomento collegato: RICOH Account Administration