Devices

Get Device Status

Get all devices from company
 
URL:
GET http://api.aurelon.com/api/v2/device/<DeviceGUID>/status
 
Request Headers:
MisKey : see Authentication
HardwareHash : see Authentication
SerialNumber : see Authentication
ApplicationVersion : see Authentication
 
Response:
Content type application/json containing the status of a device and the currently running job. If no job is running null can be returned as “CurrentJob”
 
Success:

  • 200 OK : Return device status object

Ex:
{
   “DeviceName”: “Epson Stylus Pro 4800”,
   “DeviceStatus”: “Idle”,
   “DeviceType”: “Printer”,
   “MediaSize”: “Roll 17 inch <Any>”,
   “Location”: null,
   “ComputerGUID”: “81517066-7a5b-4122-8e04-c5306b17e8c2”,
   “Rip”: “Rip-35”,
   “SerialNumber”: 344781,
   “CurrentJob”: {
“JobGUID”: null,
“Name”: null,
“Copies”: null,
“RemainingPages”: null,
“User”: null,
“Progress”: null
   },
   “InProgressJobs”: 0
}
 
Error:

  • 401 Unauthorized : {“Message”:”Invalid HardwareHash”}
  • 401 Unauthorized : {“Message”:”Invalid MisKey”}
  • 404 Not Found : {“Message”:”DeviceGUID is not found”}
  • 401 Unauthorized : {“Message”: “”MisKey” or “HardwareHash”, “SerialNumber” and “ApplicationVersion” header are required”}
  • 400 Bad Request : {“Message”:””DeviceGUID” value required”}
  • 500 Internal Server Error : {“Message”:”Internal Server Error”}

 

Update Device Status

Update the status of the device to reflect the current state. The status is transient so it overwrites the last recorded status.
 
URL:
POST http://api.aurelon.com/api/v2/device/status
 
Request Headers:
Content-Type : application/json
MisKey : see Authentication
HardwareHash : see Authentication
SerialNumber : see Authentication
ApplicationVersion : see Authentication
 
Request Body:
JSON object containing:
 

  • DeviceGUID – required string – the Device GUID
  • Status – required string – one of “Error”, “Idle”, “Offline”, “Printing”, “Aborting”, “Sleeping”, “Calibrating”
  • Message – string – Free form human readable status message
  • Temperature – number – heater temperature in celsius
  • ConnectionState – string – status from the PING messages, one of “Online”, “Offline”, “Unstable”
  • ConnectionMessage – string – Free form human readable connection status message
  • RemainingInks – array of objects – Objects containing for each ink:
  • InkIndex – required number – sequence index of the ink
  • InkName – required string – Name of the ink color
  • Level – required number – Current amount of ml of the tank, <0 indicates unknown
  • MaxLevel – required number – Max amount of ml of the tank
  • QueueLength – required object – Containing one of the following:
  • Length – number – Length of jobs in units for a roll to roll device
  • Area – number – Area of the jobs in units-sq for a rigid device
  • Sheets – number – Amount of sheets for a sheet-fed device

 
Example:
{
“DeviceGUID”: “af4da7ba-23be-11e5-850d-f3773dfc73c9”,
“Status”: “Sleeping”,
“Message”: “”,
“ConnectionState”: “Unstable”,
“ConnectionState”: “The connection with the printer is not stable.”,
“Temperature”: 30,
“RemainingInks”: [ { “InkName”: “Magenta”, “Level”: 606, “MaxLevel”: 775 }, { “InkName”: “Light magenta”, “Level”: 624, “MaxLevel”: 775 }, { “InkName”: “Light cyan”, “Level”: 661, “MaxLevel”: 775 }, { “InkName”: “Cyan”, “Level”: 565, “MaxLevel”: 775 }, { “InkName”: “Latex Optimizer”, “Level”: 668, “MaxLevel”: 775 }, { “InkName”: “Yellow”, “Level”: 575, “MaxLevel”: 775 }, { “InkName”: “Black”, “Level”: 589, “MaxLevel”: 775 }, { “InkName”: “CleanKit”, “Level”: 75, “MaxLevel”: 100 } ]
}
 
Response:
Content type application/json containing the result of the operation.
 
Success:

  • 200 OK : “Device status successfully updated”

 
Error:

  • 401 Unauthorized : {“Message”:”Invalid HardwareHash”}
  • 401 Unauthorized : {“Message”:”Invalid MisKey”}
  • 404 Not Found : {“Message”:”DeviceGUID is not found”}
  • 401 Unauthorized : {“Message”: “”MisKey” or “HardwareHash”, “SerialNumber” and “ApplicationVersion” header are required”}
  • 400 Bad Request : {“Message”:””DeviceGUID” value required”}
  • 500 Internal Server Error : {“Message”:”Internal Server Error”}

 

Get Device Queues

Get all queues for a specified device
 
URL:
GET http://api.aurelon.com/api/v2/device/<DeviceGUID>/queues
 
Request Headers:
MisKey : see Authentication
HardwareHash : see Authentication
SerialNumber : see Authentication
ApplicationVersion : see Authentication
 
Response:
Content type application/json containing all queues for the specified device by DeviceGUID
 
Success:

  • 200 OK : Return queues list

Ex:
[{
   “QueueGUID”: “9FCBF3AC-c1f9-11e6-b31e-c79f9f473700”,
   “QueueName”: “Standardized Printing 1”,
   “ProfileName”: “EPSON SC-S80600 Adhesive Color + Metallic 2 layers”,
   “MediaType”: “<Any>”,
   “MediaSize”: “Roll 42 inch”,
   “MediaSource”: “Roll”,
   “QueueType”: “Proofing Queue”,
   “DriverSettings”: “Media=Adhesive Vinyl, Inkset=Color + Metallic 2 Layers, Layer image=Surface mode, Quality=1440×1440 – 72 Pass, Screening=Epson Precision Dot, White Mode=Standard, Density Cyan (%)=100, Density Magenta (%)=100, Density Yellow (%)=100, Density Black (%)=100, Density Light Cyan (%)=100, Density Light Magenta (%)=100, Density Light Black (%)=100, Density Orange (%)=100, Density Red (%)=100, Density White/Metallic (%)=100, Print CutLine=Off, Bi-directional=Off, Custom Paper Feed=Off, Feed Offset (0.01%)=0, Drying Time Per Page (sec.)=35, =Printer panel”
},
{
   “QueueGUID”: “6DC7AD63-5E15-4ACB-85EF-1CB012A69571”,
   “QueueName”: “Standardized Printing 2”,
   “ProfileName”: “EPSON SC-S80600 Adhesive Color + Metallic 2 layers”,
   “MediaType”: “<Any>”,
   “MediaSize”: “Roll 42 inch”,
   “MediaSource”: “Roll”,
   “QueueType”: “Proofing Queue”,
   “DriverSettings”: “Media=Adhesive Vinyl, Inkset=Color + Metallic 2 Layers, Layer image=Surface mode, Quality=1440×1440 – 72 Pass, Screening=Epson Precision Dot, White Mode=Standard, Density Cyan (%)=100, Density Magenta (%)=100, Density Yellow (%)=100, Density Black (%)=100, Density Light Cyan (%)=100, Density Light Magenta (%)=100, Density Light Black (%)=100, Density Orange (%)=100, Density Red (%)=100, Density White/Metallic (%)=100, Print CutLine=Off, Bi-directional=Off, Custom Paper Feed=Off, Feed Offset (0.01%)=0, Drying Time Per Page (sec.)=35, =Printer panel”
}]
 
Error:

  • 401 Unauthorized : {“Message”:”Invalid HardwareHash”}
  • 401 Unauthorized : {“Message”:”Invalid MisKey”}
  • 404 Not Found : {“Message”:”DeviceGUID is not found”}
  • 401 Unauthorized : {“Message”: “”MisKey” or “HardwareHash”, “SerialNumber” and “ApplicationVersion” header are required”}
  • 400 Bad Request : {“Message”:””DeviceGUID” value required”}
  • 500 Internal Server Error : {“Message”:”Internal Server Error”}
Updated on May 19, 2022

Was this article helpful?