Important Update:
Transition to New Infrastructure and Impact on Jobs API Connections
As part of this transition, your current Jobs API integration with the old server will have to be updated to the new server. While we have taken every precaution to minimize disruptions, there are adjustments needed on your side to keep your integration running.
Here's what you need to know about the transition and its impact on your API connections:
- Migration Schedule: The new connection will be available for you starting July 6th,2023. For your convenience, we’ll keep the old server open until March 31, 2024. After that date, we will disable all connections to the old server.
Main API changes:
|
Changes |
Jobs API - historic context (Ending March 31, 2024) |
Print Beat API - job context (Starting July 6th,2023) |
|---|---|---|
|
endpoint |
https://printos.api.hp.com/jobs-service/jobs-sdk/jobs/historic |
https://printos.api.hp.com/printbeat/externalApi/jobs |
| limit |
Up to 1000 per call (can be set) |
Up to 100 per call (fixed) |
| rate | 3 requests per minute | 2 requests per minute |
|
selection |
A comma-separated list of the names of the properties to return. |
fixed Json with all properties (cannot be selective) |
|
new properties |
Ink Serial Number, Job Width & Height, Site Name |
|
| Marker | New Marker, not correlated with the Jobs API - historic | |
| Supported Presses | HP Indigo Series 3 Presses and above |
HP Indigo Series 3 and above, except HP Indigo W72X0 presses |
| Device selection | PrintOS Device ID | Press Serial Number |
| connector | Jobs Enquiries | Jobs Enquiries |
-
Head to Getting Started with the PrintOS Print Beat API to get more details about the new jobs API endpoint Documentation, list of Properties, Jobs context Markers and paging, API Test Page and new code samples at GitHub repository.
- Support and Assistance: Our dedicated support team will be available throughout the migration process to address any questions or concerns you may have. We are committed to assisting you and making this transition as seamless as possible.
We understand that Jobs API integration is critical to your business, and we assure you that we are taking all necessary steps to ensure a successful transition. Our goal is to provide you with an improved infrastructure that offers your business improved performance and reliability.
We appreciate your understanding and cooperation during this transition and look forward to delivering even better services in the future.
- Job Print Attempt Example:
-
{ "pressSerialNumber": "90000000", "jobName": "Job 52493187", "siteName": null, "copies": 103, "impressions": 618, "printedSheets": 103, "jobSubmitTime": "2023-07-01T03:32:54.000+00:00", "jobCompleteTime": "2023-07-01T03:35:25.000+00:00", "epmImpressions": 618, "width": 640, "useOfVDP": "No", "printedJobId": "90000000_5191561_1688166144000_1688166144000", "height": 450.0, "deviceId": "35e3ab74-8d30-4fff-91c9-b64487cfa7b1", "marker": 33247014, "repeatLength": 0, "impressionsType": "B2", "duplex": true, "oneShotImpressions": 0, "impressions1Color": 0, "impressions2Colors": 0, "impressionsNColors": 0, "inkUnits": "IMPRESSIONS", "jobElapseTime": 151, "jobProgress": "PRINTED", "jobCollation": null, "substrateUnits": { "value": "103", "unit": "SHEETS" }, "substrates": [ { "name": "350 Silk SRA2", "amountUsed": 103 } ], "inks": [ { "color": "Yellow", "amountUsed": 206, "inkSerialNumber": "XTY2Y384534.750275" }, { "color": "Cyan", "amountUsed": 206, "inkSerialNumber": "XTC2X354034.750330" }, { "color": "Magenta", "amountUsed": 206, "inkSerialNumber": "XTM2Y370034.750271" } ] },