# Miniaturen rendern (https://developer.bimetrics.de/reference/layouts/render-layout-thumbnails)

`POST https://app.bimetrics.de/api/layouts/thumbnails`

operationId: `renderLayoutThumbnails` · Berechtigung (Scope): `sales:read` · Bereich: Layouts

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`.

### Authentifizierung

`Authorization: Bearer bm_…` (alternativ `X-API-KEY: bm_…`, nie beide zugleich).

### Request-Body (`application/json`)

`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).



### Beispiel

```sh
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"}]}]}'
```

### Antworten

| Status | Beschreibung | Inhalt |
| --- | --- | --- |
| 200 | Erfolg. | `application/json`: LayoutThumbnails |
| 400 | Ungültige Anfrage, z. B. ein Parameter mit ungültigem Wert wie eine ID, die keine UUID ist; korrigieren statt wiederholen. Mehr unter [Fehler](https://developer.bimetrics.de/errors). | `application/json`: Error |
| 401 | Kein gültiger Schlüssel: fehlt (`Unauthorized`), ist unbekannt, abgelaufen oder widerrufen oder wurde nicht in genau einem Header gesendet (`InvalidAPIKey`). Schlüssel prüfen, nicht wiederholen. Auch eine ID, die zu einer anderen Firma gehört, ergibt `401 Unauthorized`. | `application/json`: Error |
| 403 | Dem Schlüssel fehlt die Berechtigung für diese Route (`APIKeyPermissionDenied`), oder die Firma hat keinen API-Zugang (mehr), etwa nach Ende der Testphase oder des Abos (`APIUnavailable`). | `application/json`: Error |
| 404 | Nicht gefunden (`NotFound`). | `application/json`: Error |
| 413 | Die Anfrage ist zu groß (`APIRequestTooLarge`), siehe `x-bimetrics-limits`. | `application/json`: Error |
| 429 | Zu viele Anfragen; nach `Retry-After` Sekunden erneut senden. Mehr unter [Fehler](https://developer.bimetrics.de/errors). (Header: Retry-After) | `application/json`: Error |
| 500 | Serverfehler; die Anfrage später wiederholen. Mehr unter [Fehler](https://developer.bimetrics.de/errors). | `application/json`: Error |

#### Felder der Antwort 200 (`LayoutThumbnails`)

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `items` | Array<LayoutThumbnail>, kann null sein | Je Eintrag der Anfrage ein Bild. |

Verschachtelte Schemas stehen vollständig in der OpenAPI-Beschreibung: https://app.bimetrics.de/api/openapi.json