01. Getting Started
To begin printing from the cloud, you need two components: a Project API Key from your dashboard and a Local Agent installed on the target machine.
Production Endpoint
https://api.printwithit.com/v1
Documentation v1.4.2
Engineering Manual.
Everything you need to integrate the PrintWithIt cloud bridge into your application. From local agent deployment to complex ESC/POS payload structures.
02. Authentication
Every request must include your Secret Key in the Authorization header as a Bearer token.
Request Header
GET /v1/nodes
// Authorization Header
Authorization: Bearer PW_SEC_77X4_YOUR_KEY
03. Payload Execution
The /execute endpoint accepts a JSON object containing the target node_id and the print content.
POST Payload (JSON)
Standard Node
{
"node_id": "KANDY_RETAIL_01",
"content": "LKR 5,000.00 Paid",
"options": {
"cut": true,
"align": "center"
}
}
04. Infrastructure Codes
| Code | Handshake Status |
|---|---|
| NODE_OFFLINE | The local agent is not heartbeating. |
| AUTH_FAILED | Invalid Bearer Hardware Token. |
| PAPER_OUT | Node reports empty thermal roll. |
Need a pre-built integration?
If you are using ReceiptsPOS, you do not need to read these docs. Your cloud bridge is pre-configured with a native 7,000 monthly print bonus.
Go to ReceiptsPOS