Miniaturen rendern
Benötigte Berechtigung:sales:read(Ausgangsrechnungen und Entwürfe lesen)
Rendert die erste Seite von bis zu 12 Layouts als kleines PNG, je auf dem Musterbeleg einer Belegart, wahlweise mit ungespeicherten Operationen. Speichert nichts. Je Firma rendert ein Aufruf, ein weiterer wartet. Es gelten dieselben Grenzen wie in der App, dazu 60 Aufrufe je Minute und Schlüssel.
Benötigt einen Schlüssel mit der Berechtigung sales:read oder read.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
items: 1 bis 12 Einträge mit layoutId (ID oder standard), documentType (ein Schlüssel von cases im Katalog, etwa invoice oder xrechnung) und optional operations (höchstens 20).
application/json- body
Erfolg.
application/json- response
Miniaturen in der Reihenfolge der Anfrage.
items?array<>|Je Eintrag der Anfrage ein Bild.
curl --fail-with-body "https://app.bimetrics.de/api/layouts/thumbnails" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"items":[{"documentType":"invoice","layoutId":"standard"},{"documentType":"proposal","layoutId":"bab564a1-86e9-45aa-98d7-2410bd59ba4b","operations":[{"id":"friendly","op":"recipe"}]}]}'{ "items": [ { "png": "iVBORw0KGgo=" }, { "png": "iVBORw0KGgo=" } ]}Vorschau rendern POST
Rendert ein Layout als SVG-Seiten und speichert nichts: das aktuelle Layout einer Belegart, eine Version (`versionId`) oder eine Gestaltung (`spec`), jeweils mit ungespeicherten Operationen (`operations`, wie bei `changeLayout`). Gezeigt wird ein Musterbeleg mit den Daten der Firma (`source.kind` `sample` mit `documentType` und `case` aus dem Katalog), ein eigener Entwurf (`draft` mit `documentType` und `id`) oder ein ausgestellter Beleg (`issued` mit `id`). Je Firma läuft eine Vorschau: Eine neuere, auch im Editor, beendet die ältere mit `409 PreviewSuperseded`. Eine ID einer anderen Firma ergibt `404 LayoutNotFound`. Es gelten dieselben Grenzen wie in der App, dazu 60 Aufrufe je Minute und Schlüssel. Benötigt einen Schlüssel mit der Berechtigung `sales:read` oder `read`.
Version wiederherstellen POST
Legt eine neue Version mit dem Stand einer älteren Version desselben Layouts an, wie „Wiederherstellen“ im Editor; `originRef` nennt die wiederhergestellte. So lässt sich jede Änderung zurücknehmen. Eine Version mit `check: failed` lässt sich nicht wiederherstellen. Idempotency-Key bei Wiederholung unverändert senden. Benötigt einen Schlüssel mit der Berechtigung `layout:write`.