Utilizzo della documentazione RICOH ProcessDirector REST API

RICOH ProcessDirector fornisce REST API per l'integrazione del servizio Web. Con queste API viene fornita una documentazione interattiva che offre test in diretta e informazioni per ogni API disponibile.

La documentazione REST API include molte API che un'applicazione può usare per l'integrazione con RICOH ProcessDirector. È possibile utilizzare la documentazione REST API e l'interfaccia di test per collaudare le impostazioni dei parametri. Quando si utilizza l'interfaccia per collaudare i servizi Web, è possibile accedere al server primario di RICOH ProcessDirector. Azioni quali la creazione, l'eliminazione e l'abilitazione di oggetti sono eseguite sul server primario e si riflettono nell'interfaccia utente di RICOH ProcessDirector. Di conseguenza, si consiglia di creare oggetti appositamente per i test.

Queste operazioni mostrano come richiedere i file di registro per un oggetto usando le REST API. Queste operazioni consentono di accedere a RICOH ProcessDirector, richiedere i file di registro per la stampante di esempio e disconnettersi.

  1. Aprire un browser Web e inserire il proprio nome host o indirizzo IP RICOH ProcessDirector nella barra degli indirizzi. Aggiungere /restapi/ alla fine del nome host o dell'indirizzo IP per accedere alla documentazione REST API. Ad esempio, http://hostname:15080/restapi/
  2. Nella sezione utenti, trovare POST /users/login.
  3. Fare clic su Provalo.
  4. Accedere a RICOH ProcessDirector inserendo le proprie credenziali RICOH ProcessDirector:
    • Per il parametro name, inserire il proprio nome utente RICOH ProcessDirector.
    • Per il parametro pwd, inserire la password associata al proprio nome utente RICOH ProcessDirector.
  5. Fare clic su Esegui.
    La documentazione REST API utilizza i valori inseriti per creare un comando cURL e un URL di richiesta. Quindi inoltra la richiesta all'URL interessato e disconnette l'utente.

    RICOH ProcessDirector invia una risposta indicando l'avvenuto accesso. La risposta include informazioni aggiuntive, inclusi il token e le azioni che possono essere eseguite da questo ID utente.

  6. Nella casella Corpo risposta, individuare e copiare il valore del token.

  7. Nella sezione oggetti, scorrere in basso fino a individuare POST /objects/log/{objectType}/{name}.
  8. Fare clic su Provalo.
  9. Recuperare i messaggi di registro per la stampante di esempio inserendo questi parametri:
    1. Per il parametro token, incollare il token copiato in precedenza.
    2. Per il parametro objectType, digitare Stampante.
      I valori per objectType sono sensibili alla distinzione tra maiuscole e minuscole. È possibile utilizzare il servizio Web POST /util/objecttypes per ottenere l'elenco dei tipi di oggetti disponibili sul proprio sistema. Il servizio Web POST /util/objecttypes si trova nella sezione util.
    3. Per il parametro name, digitare Esempio.
  10. Fare clic su Esegui.
    Le voci di registro per la stampante di esempio vengono restituite nella casella Corpo risposta.

    Vengono restituiti anche i valori cURL e URL di richiesta.

  11. Nella sezione utenti, trovare POST /users/logout/{name}.
  12. Fare clic su Provalo.
  13. Disconnettersi da RICOH ProcessDirector:
    • Per il parametro token, incollare il token copiato in precedenza.
    • Per il parametro name, inserire il proprio nome utente RICOH ProcessDirector.
  14. Fare clic su Esegui.
    Verrà eseguita la disconnessione da RICOH ProcessDirector.

  15. Con alcune API sono inclusi valori di esempio. Con i valori di esempio, è possibile il codice di esempio e modificarlo per eseguire il test.

    Queste operazioni mostrano come utilizzare una REST API per connettersi a una hot folder utilizzando un valore di esempio. Queste operazioni consentono di accedere a RICOH ProcessDirector, impostare il dispositivo di input in modo da accettare i file da HotFolderPDF e disconnettersi.

  16. Aprire l'interfaccia API REST come indicato sopra.
  17. Nella sezione utenti, trovare POST /users/login.
  18. Fare clic su Provalo.
  19. Accedere a RICOH ProcessDirector inserendo le proprie credenziali RICOH ProcessDirector:
    • Per il parametro name, inserire il proprio nome utente.
    • Per il parametro pwd, inserire la password associata al proprio nome utente.
  20. Fare clic su Esegui.
  21. Nella casella Corpo risposta, individuare e copiare il valore del token.
  22. Nella sezione oggetti, scorrere fino a individuare POST /objects/{objectType}/connect.
  23. Fare clic su Provalo.
  24. Connettersi a HotFolderPDF inserendo questi parametri:
    1. Per il parametro token, incollare il token copiato in precedenza.
    2. Per il parametro objectType, digitare InputDevice.
      I valori per objectType sono sensibili alla distinzione tra maiuscole e minuscole. È possibile utilizzare il servizio Web POST /util/objecttypes per ottenere l'elenco dei tipi di oggetti disponibili sul proprio sistema. Il servizio Web POST /util/objecttypes si trova nella sezione util.
    3. Per il parametro relativo al corpo, fare clic su Modifica valore. Il testo di esempio viene visualizzato in una casella di codice. Sostituire la parola “stringa” con “HotFolderPDF”. Assicurarsi che il nome dell'oggetto sia compreso tra i doppi apici.
  25. Fare clic su Esegui.
    Le proprietà e le impostazioni per HotFolderPDF vengono restituite nella casella Corpo risposta. Vengono restituiti anche il codice e le intestazioni della risposta.
  26. Nella sezione utenti, trovare POST /users/logout/{name}.
  27. Fare clic su Provalo.
  28. Disconnettersi da RICOH ProcessDirector:
    • Per il parametro token, incollare il token copiato in precedenza.
    • Per il parametro name, inserire il proprio nome utente RICOH ProcessDirector.
  29. Fare clic su Esegui.
    Verrà eseguita la disconnessione da RICOH ProcessDirector.

Related information:

Preparazione per l'invio di lavori tramite i servizi Web
Argomento collegato: Servizi Web in RICOH ProcessDirector