In addition to the summary status URLs for printers and devices, PaperCut NG/MF provides URLs for every printer and every device. You can use either the JSON attribute on each of these URLs, or the HTTP response codes depending on the capabilities of your monitoring tool.
These URLs provide the following simple HTTP response codes that can be consumed by most monitoring tools:
-
200—Success
-
500—Error
For example, if a printer is offline, the /api/health/printers/[printer Id]/status URL will return a status code of 500 (Error).
If you use the JSON attribute, more detailed status information is available when the status is not OK, for example, “Printer is out of toner”.
EXAMPLE
Per printer URLs
The printer URLs are located below:
http://[primary_server]:[port]/api/health/printers/[printer Id]
The following URLs are provided per printer.
| URL | Attribute | Description |
|---|---|---|
| /status | status | The status of the printer.This is either OK, or an error message is displayed. |
| comment | A description of the URL. | |
| /has-recent-jobs?minutes=60 | status | Indicates whether or not a job has been sent to the printer in a defined period of time. The default time period is 60 minutes, however, you can change this to a value up to 240 minutes by changing the ?minutes=60 value. |
| comment | A description of the URL. |
Per device URLs
The device URLs are located below:
http://[primary_server]:[port]/api/health/devices/[device Id]
The following URLs are provided per device.
| URL | Attribute | Description |
|---|---|---|
| /status | status | The status of the device in error.This is either OK, or an error message is displayed. |
| comment | A description of the URL. | |
| /has-recent-jobs?minutes=60 | status | Indicates whether or not a job has been sent to the device in a defined period of time. The default time period is 60 minutes, however, you can change this to a value up to 240 minutes by changing the ?minutes=60 value. |
| comment | A description of the URL. |
Comments