Agent & WebSocket

Agent & WebSocket

Agent startup flow

  1. Register computer: POST /v1/agents/register
  2. Report printers: POST /v1/agents/printers/report
  3. Connect WebSocket: /v1/agents/connect?token=...
  4. Receive dispatch and report status

Server -> Agent

{
  "type":"job.dispatch",
  "payload":{
    "job_id":"job_abc",
    "printer_id":"printer_123",
    "download_url":"https://...",
    "options":{"copies":1}
  }
}

Agent -> Server status update

{
  "type":"job.status",
  "payload":{
    "job_id":"job_abc",
    "status":"completed"
  }
}

Failure example:

{
  "type":"job.status",
  "payload":{
    "job_id":"job_abc",
    "status":"failed",
    "reason_code":"PRINT_ERROR",
    "message":"Driver error"
  }
}
Agent & WebSocket