Open Inventory / Docs
EndpunkteLabel printingLabel print jobs

Queue a prepared PT-P710BT print job

Die API läuft auf deiner Anwendungsinstanz. Schemas und Feldnamen stammen unverändert aus der OpenAPI-Spezifikation. Browsergebundene Aufrufe benötigen eine Sitzung auf der Instanz.

POST
/label-print-jobs

Requires a browser session with labels.read. The browser renders and validates labels before submission. Reuse body.id only with identical data to retrieve an existing job. Limits: 100 labels, 4 MB RAW data, 10 submissions/minute per user/printer and 20 pending jobs per printer. Queued jobs expire after 10 minutes.

Authentifizierung

adminSession
cookieauthjs.session-token<token>

Authenticated Auth.js browser session cookie; each operation declares its required permission. Not restricted to administrators. HTTPS deployments use the secure-prefixed cookie variant.

Header-Parameter

X-Organization-ID?string

Organization membership selected for this request. User-bound credentials may select any active membership; standalone tokens may only repeat their pinned organization ID.

Formatuuid

Anfrageinhalt

application/json
  1. body

id is a client-generated UUID used for idempotency. labels contains base64-encoded PT-P710BT raster labels, not images or arbitrary printer commands. All labels must use the printer tape width. At most 100 labels and 4,000,000 bytes in the combined RAW job.

id*string
Muster^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
printerId*string
Muster^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
tape*number
Mögliche Werte3.569121824
labels*array<>
Einträge1 <= items <= 100

Antwortinhalt

Queued job or replay of the same submission.

application/json
  1. response
job*

submitted confirms Windows spooler acceptance, not physical output. uncertain jobs are never automatically reprinted.

Beispielanfrage
curl -X POST 'https://inventory.example.com/api/v1/label-print-jobs' \  -H 'Content-Type: application/json' \  -d '{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "printerId": "dcfa0f1a-9e85-45da-bde8-dd0c8dec8352",  "tape": 3.5,  "labels": [    "string"  ]}'
Beispielantwort
{  "job": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "printerId": "dcfa0f1a-9e85-45da-bde8-dd0c8dec8352",    "count": 1,    "status": "queued",    "createdAt": "2019-08-24T14:15:22Z",    "spoolJobId": 0  }}