Turns the text read from one or two QR codes into what a scanning app should show: each tag's target (a printer with its live status, a slot with what is assigned to it and whether the printer sees a spool, a filament variant, a spool with its weight and the slot it is loaded in, or a blank tag with its code), every action the scan offers, and which of those the scanner can run right now. Needs qr.scan and the QR Workflows add-on. Each call counts as a scan on every tag it finds (scanCount, lastScannedAt). A blank isn't saved until it is set up, so scanning one writes nothing.

mode says how to read the result. Every mode other than single comes with a message you can show as is:

Text that isn't a Printago payload at all (a link to another page, a Wi-Fi code, JSON without a numeric v) is a 400 with the message "This QR code isn't a Printago tag." Scanning the same tag twice in one request counts as one tag. The payload format is described under POST /v1/qr-tags.

Each action has available, and when it is false, a reasonCode and a reason such as "Printer is offline", "Printer is printing", "No jobs are waiting in the queue" or "You don't have permission". When a printer's live status can't be read within 3 seconds, the printer's statusLabel is "Status unavailable" and the actions that need its live status have reasonCode status_unknown; resolve again to retry. Actions that only change Printago's records, such as loading a spool into a slot, stay available. At most one action has default: true: for a printer, Confirm ready while it is waiting for confirmation, Resume while it is paused, otherwise Open printer; for a slot, Assign filament; for a variant, Assign to a printer; for a pair, its one action, whose label names the outcome ("Move PLA Basic Red to A2/1", "Swap A1/3 and S1"). Destructive actions (Stop, Disable, Clear all slots) are never the default. Actions with confirm: true carry a confirmMessage to ask before running them. Actions whose runs is app (Open printer) are handled by the client and are never sent to POST /v1/qr-tags/execute.

A slot tag's display has slot: ref (A1/3, S1), assigned (the filament's name, brand and color, plus instanceId and remainingGrams when a spool is loaded there, or null), loaded (the printer reports a spool there) and exists (false while the printer doesn't report the slot, for example with its AMS unplugged; its actions are then unavailable). A variant tag's display has variant with its name, material, brand, type and color. A spool tag's display has spool: its variant, remainingGrams, nominalGrams, labelCode, empty (no filament left) and location (printerId, printerName, amsIndex, slotIndex, ref of the slot it is loaded in, or null). A blank tag's display has blank with its code.

A tag's record, not its printed payload, says what it is: a blank that was set up resolves as the printer, slot, variant or spool it was set up for, though its QR code still says "t": "blank".

Setting a blank up without scanning a second tag

A blank's payload is a link (see POST /v1/qr-tags); send it as it was read, or the JSON of a blank printed before blank payloads were links. Either resolves the same. To set a blank up for something that has no tag to scan, as the blank's page on Printago on the web does, send the blank's payload alone with a target, shaped like a target of POST /v1/qr-tags: {"entityType": "printer", "entityId"}, {"entityType": "printer_slot", "entityId", "amsIndex", "slotIndex"}, {"entityType": "material_variant", "entityId"} or {"entityType": "material_instance", "entityId"}. The blank and the target resolve as the pair they would be when scanned together, with the same actions, main button and settings; tags lists only the blank. Send refresh: true so choosing a target doesn't count another scan. A target that isn't in the store is a 404 with code: "target_not_found", and a target with two payloads is a 400. Once the tag isn't a blank anymore the target is ignored, and the response says what the tag is for now. Run the chosen action with POST /v1/qr-tags/execute, passing the same target.

Spool actions: on its own a spool offers Update grams (the default), Remove from its slot (when loaded), Load into a printer, Mark empty (asks first; it also clears the spool's slot) and Open printer. A variant on its own also offers Register spool. With a printer that has one slot, a spool's load needs no choice and its label names the slot ("Load into S1"); with more slots it asks for one. A load that moves a spool out of another slot says so in label ("Move Jade White to A1/3") and in detail, a second line to show under the button ("Takes it out of A1/2 · X1C-01"). Setting up a blank needs qr.manage, registering a spool material.instance.create, and weighing or marking a spool empty material.instance.edit.

An available action that needs a choice carries a param, with its options and the default to pick. Send the pick to execute as params: