Using RICOH ProcessDirector REST API documentation

RICOH ProcessDirector provides REST APIs for web service integration. Interactive documentation is provided with these APIs and provides live testing and information for each available API.

The REST API documentation includes many APIs that an application can use to integrate with RICOH ProcessDirector. You can use the REST API documentation and testing interface to test your parameter settings. When you use the interface to test web services, you access the RICOH ProcessDirector primary server. Actions such as creating, deleting, and enabling objects are executed on the primary server and are reflected in the RICOH ProcessDirector user interface. As a result, we suggest creating objects specifically for testing purposes.

These steps demonstrate how to request the log files for an object using REST APIs. These steps log you in to RICOH ProcessDirector, request the log files for the Sample printer, and log you out.

  1. Open a Web browser and enter your RICOH ProcessDirector hostname or IP address into the address bar. Add /restapi/ to the end of your hostname or IP address to access the REST API documentation. For example, http://hostname:15080/restapi/
  2. In the users section, click Expand Operations and find GET /users/login.
  3. Log in to RICOH ProcessDirector by entering your RICOH ProcessDirector credentials:
    • For the name parameter, enter your RICOH ProcessDirector user name.
    • For the pwd parameter, enter the password associated with your RICOH ProcessDirector user name.
  4. Click the Try it Out!
    The REST API documentation uses the values you enter to build a Curl command and a Request URL. Then it submits the request to the request URL and logs you in.

    RICOH ProcessDirector sends a response indicating whether you successfully logged in. The response includes additional information including the token and the actions that this User ID is allowed to do.

  5. In the Response Body box, find and copy the token value.

  6. In the objects section, click Expand Operations. Scroll down until you find GET /objects/log/{objectType}/{name}.
  7. Retrieve the log messages for the Sample printer by entering these parameters:
    1. For the token parameter, paste the token you copied above.
    2. For the objectType parameter, type Printer.
    3. The values for objectType are case-sensitive. You can use the web service GET /util/objecttypes to get a list of object types available on your system. The web service GET /util/objecttypes is found in the util section.
    4. For the name parameter, type Sample.
  8. Click the Try it Out!
    The log entries for the Sample printer are returned in the Response Body box.

    The Curl and Request URL values are also returned.

  9. In the users section, click Expand Operations and find POST /users/logout/{name}.
  10. Log out of RICOH ProcessDirector:
    • For the token parameter, paste the token you copied above.
    • For the name parameter, enter your RICOH ProcessDirector user name.
  11. Click the Try it Out!
    You are logged out of RICOH ProcessDirector.

  12. Example values are included with certain APIs. With example values you can copy a sample string of code into the body field and modify it for testing.

    These steps demonstrate how to use a REST API to connect a hot folder. These steps log you in to RICOH ProcessDirector, set the Input Device to accept files from HotFolderPDF, and log you out.

  13. Open a Web browser and enter your RICOH ProcessDirector hostname or IP address into the address bar. Add /restapi/ to the end of your hostname or IP address to access the REST API documentation. For example, http://hostname:15080/restapi/
  14. In the users section, click Expand Operations and find GET /users/login.
  15. Log in to RICOH ProcessDirector by entering your RICOH ProcessDirector credentials:
    • For the name parameter, enter your RICOH ProcessDirector user name.
    • For the pwd parameter, enter the password associated with your RICOH ProcessDirector user name.
  16. Click the Try it Out!
    The REST API documentation uses the values you enter to build a Curl command and a Request URL. Then it submits the request to the request URL and logs you in.

    RICOH ProcessDirector sends a response indicating whether you successful logged in. The response includes additional information including the token and the actions that this User ID is allowed to do.

  17. In the Response Body box, find and copy the token value.
  18. In the objects section, click Expand Operations. Scroll down until you find POST /objects/{objectType}/connect.
  19. Connect HotFolderPDF by entering these parameters:
    1. For the token parameter, paste the token you copied above.
    2. For the objectType parameter, type InputDevice.
      The values for objectType are case-sensitive. You can use the web service GET /util/objecttypes to get a list of object types available on your system. The web service GET /util/objecttypes is found in the util section.
    3. For the body parameter, click the Example Value. The text inside the Example Value is copied into the body parameter. Replace the word “string” with “HotFolderPDF”. Make sure the double quotes are around the name of the object.
  20. Click the Try it Out!
    The properties and settings for HotFolderPDF are returned in the Response Body box. The Response Code and Response Headers are also returned.
  21. In the users section, click Expand Operations and find POST /users/logout/{name}.
  22. Log out of RICOH ProcessDirector:
    • For the token parameter, paste the token you copied above.
    • For the name parameter, enter your RICOH ProcessDirector user name.
  23. Click the Try it Out!
    You are logged out of RICOH ProcessDirector.

Related information:

Preparing to submit jobs using web services
Preparing to submit jobs using web services
Preparing to submit jobs using web services
Parent topic: Web services in RICOH ProcessDirector