Wie erzeuge und drucke ich einen QR-Code?

Ab Tarif Basic

Kurzantwort

Jedes Asset erhält beim Anlegen automatisch einen QR-Code. Du musst nichts konfigurieren. In der Detailansicht findest du den Bereich QR-Code mit der Schaltfläche „QR-Code herunterladen”: Das PNG druckst du als Etikett und klebst es auf das Gerät. Per API liefert GET /api/v1/assets/{id}/qr dasselbe Bild.

Voraussetzungen

QR-Codes sind Teil des Asset-Moduls und in allen Tarifen verfügbar.

Asset öffnen. Wähle Assets und klicke das gewünschte Asset an. In der Detailansicht rechts liegt die Karte QR-Code mit dem Bild.

Screenshot ausstehend assets-qr-01 Detailansicht eines Assets mit der QR-Code-Karte und der Schaltfläche 'QR-Code herunterladen'

Die QR-Code-Karte in der Asset-Detailansicht.
Herunterladen. Klicke auf „QR-Code herunterladen”. Du erhältst ein PNG in Druckqualität.
Drucken und aufkleben. Drucke das PNG über einen Etikettendrucker (oder auf Etikettenbögen) und bringe das Etikett gut sichtbar am Gerät an. Bewährt haben sich Größen ab 25 × 25 mm. Kleiner gedruckte Codes lassen sich mit Smartphone-Kameras schlechter erfassen.

Das QR-Bild liegt hinter dem Endpunkt aus dem Feld qr_code_url des Assets:

curl -H "Authorization: Bearer inv_dein_token" \
  https://demo.notory.io/api/v1/assets/a2f1c9e4-7b3d-4a11-9c2e-8f6b1d0a7e55/qr \
  --output asset-qr.png

Die Antwort ist ein Binärbild (HTTP 200, Content-Type: image/png). Ideal, um Etiketten für viele Assets zu automatisieren, z. B. in einer Schleife über die Asset-Liste:

for id in $(curl -s -H "Authorization: Bearer inv_dein_token" \
  "https://demo.notory.io/api/v1/assets?status=active&page_size=100" \
  | jq -r '.items[].id'); do
  curl -s -H "Authorization: Bearer inv_dein_token" \
    "https://demo.notory.io/api/v1/assets/$id/qr" --output "qr-$id.png"
done

Mögliche Fehler: 401 (Token fehlt/ungültig), 404 (Asset existiert nicht, liegt im Papierkorb oder gehört zu einem anderen Mandanten).

Was passiert dabei?

Erzeugung bei Bedarf: Das PNG wird beim Abruf frisch generiert. Es wird kein Bild auf dem Server gespeichert. Der Abruf lässt sich beliebig oft wiederholen.
Inhalt des Codes: Der QR-Code enthält die Kerndaten des Assets als JSON: id, name, type und serial (Seriennummer). Er funktioniert damit auch offline: Jede Scanner-App zeigt die Daten direkt an, ohne dass eine Internetverbindung oder ein Notory-Login nötig ist.
Momentaufnahme: Name und Seriennummer im Code entsprechen dem Stand zum Zeitpunkt des Abrufs. Die id ist dauerhaft stabil. Nach einer Umbenennung des Assets lohnt sich ein neues Etikett, zwingend ist es nicht.
Mandanten-Isolation: Der Abruf ist authentifiziert und auf deinen Mandanten beschränkt; fremde Asset-IDs liefern 404.
Kein Gating: QR-Codes stehen in jedem Tarif zur Verfügung.