Skip to content

POST /print-job

Create Print Job

POST
/print-job

Dispatch a print job to a printer via NATS request/reply.

Publishes a print job payload to progress.print.jobs.{printer_key} and
waits for a response from the print service worker. The timeout scales with
job.copies to accommodate multi-copy jobs.

Returns a result dict with ok: true on success. On failure, ok is false
and error contains one of: no_service, timeout, or internal.

On successful print, publishes a PRINT_JOB_COMPLETED notification on the
production NATS subject.

Emits: (NATS publish — progress.print.jobs.{printer_key})

Required scope: quality:print-template:read

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/auth"
Scopes:
  • "admin"User can access and edit users and system settings
  • "library"User can access and edit products
  • "production"User can access and edit production plans
  • "operator"User can access the operator panel and make production declarations

Request Body

application/json
JSON
{
  
"printer_host": "string",
  
"printer_port": 9100,
  
"format": "string",
  
"data": "string",
  
"copies": 1,
  
"timeout_seconds": 5,
  
"printer_key": "string"
}

Responses

Print job result — check 'ok' field; may be false if the print service is unavailable or timed out

application/json
JSON
{
  
"additionalProperties": "string"
}

Samples

Powered by VitePress OpenAPI

Released under the Apache 2.0 License.