App-Zeichen löschen
Benötigte Berechtigung:layout:write(Layouts und Logo ändern)
Echte Wirkung
/api/company/logos/appKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
Löscht das eigene App-Zeichen. bimetrics macht das Zeichen wieder aus dem Rechnungslogo, ohne Rechnungslogo zeigt die App das bimetrics-Zeichen.
Benötigt einen Schlüssel mit der Berechtigung layout:write.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
expectedLogoId?stringOptional: die ID des aktiven Bildes wie gelesen (invoice.active.id beim Rechnungslogo, app.id beim App-Zeichen), leer, wenn es keins gab. Hat sich das Logo seitdem geändert, antwortet die Route mit 409 LogoChanged und ändert nichts. Ohne den Parameter prüft die Route nichts.
Idempotency-Key*stringStabiler Schlüssel für genau diese Änderung: 1–128 druckbare ASCII-Zeichen ohne Leerzeichen. Bei Wiederholungen denselben Schlüssel und unveränderten Inhalt senden; das Ergebnis wird nicht nochmals erzeugt.
^[!-~]+$1 <= length <= 128Erfolg.
application/json- response
Das Logo der Firma. Ändern geht mit layout:write und gilt für alle Layouts.
app?|Das App-Zeichen; null für das bimetrics-Zeichen.
enabled?booleanImmer true, das Logo lässt sich ändern.
frame?Der Logo-Rahmen des Layouts der Firma.
invoice?|Das Rechnungslogo; null ohne Logo.
curl --fail-with-body "https://app.bimetrics.de/api/company/logos/app" -X DELETE \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Idempotency-Key: rechnung-2026-001"{ "app": { "dark": { "blob": { "id": "3e9b1c5a-7d24-4f8e-b6a0-1c9d3e5f70e5", "sha256": "e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5" } }, "id": "8a41e7d3-6c25-4b9f-a0d8-2e5f7c3b1d94", "light": { "blob": { "id": "3e9b1c5a-7d24-4f8e-b6a0-1c9d3e5f70d4", "sha256": "d4d4d4d4d4d4d4d4d4d4d4d4d4d4d4d4d4d4d4d4d4d4d4d4d4d4d4d4d4d4d4d4" } }, "source": "mark" }, "enabled": true, "frame": { "heightMm": 16, "layout": "modern", "widthMm": 48 }, "invoice": { "active": { "blob": { "id": "3e9b1c5a-7d24-4f8e-b6a0-1c9d3e5f70a1", "sha256": "a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1" }, "dpiInFrame": 317, "height": 600, "id": "5f0c9f1e-2b7a-4c55-9d1a-7d2f5b0e3a41", "variant": "fitted", "width": 1200 }, "canRestoreOriginal": false, "facts": { "aspectRatio": 3, "color": "#1F5F5B", "contrastOnWhite": 9.4 }, "hints": [ "wide_border" ], "inverse": { "blob": { "id": "3e9b1c5a-7d24-4f8e-b6a0-1c9d3e5f70b2", "sha256": "b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2" }, "height": 600, "width": 1200 }, "proposal": { "blob": { "id": "3e9b1c5a-7d24-4f8e-b6a0-1c9d3e5f70c3", "sha256": "c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3" }, "dpiInFrame": 635, "fixes": [ "crop" ], "height": 400, "id": "c2d6a8e4-91b3-4f0a-8e5c-3b7d1a9f6e20", "width": 1200 } }}Logo lesen GET
Liefert das aktive Rechnungslogo mit Größe, Auflösung im Logo-Rahmen des Layouts (`dpiInFrame`) und Hinweisen, einen offenen Vorschlag von „Mach es passend“, die helle Fassung und das App-Zeichen. Die Bilder lädt `GET /api/blob/{sha256}/{id}` mit `blob.sha256` und `blob.id`, mit demselben Schlüssel. Die IDs der aktiven Bilder sind `expectedLogoId` der Änderungen. Benötigt einen Schlüssel mit der Berechtigung `read`.
App-Zeichen hochladen PUT
Lädt ein eigenes App-Zeichen hoch, das Zeichen der Firma in der App. Es ersetzt das Zeichen, das bimetrics aus dem Rechnungslogo macht. Zählt zu den 20 Logo-Uploads je Firma und Tag. Idempotency-Key bei Wiederholung unverändert senden. Benötigt einen Schlüssel mit der Berechtigung `layout:write`.