Seite eines Anhangs ansehen
Benötigte Berechtigung:inbox:read(Postfach lesen)
Echte Wirkung
/api/email/inbox/item/{id}/attachment/{aid}/previewKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
Liefert eine Seite eines Anhangs als Bild (Base64), wie die Vorschau im Postfach, nur für Anhänge mit valid = true, sonst 409 InboxAttachmentNotImportable. pageCount nennt die Seiten; eine Seite dahinter kommt ohne pages. Der erste Aufruf rendert die Datei und kann einige Sekunden dauern.
Benötigt einen Schlüssel mit der Berechtigung inbox:read.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
id*stringID der Mail (UUID).
uuidaid*stringID eines Anhangs dieser Mail (UUID).
page?integerSeite, ab 1; ohne Angabe 1.
Erfolg.
application/json- response
Eine Seite eines Anhangs.
ok?booleanDie Datei ließ sich darstellen.
page?integerAngefragte Seite.
pageCount?integerSeiten insgesamt.
pages?array<>|Die angefragte Seite.
curl --fail-with-body "https://app.bimetrics.de/api/email/inbox/item/497f6eca-6276-4993-bfeb-53cbbbba6f08/attachment/string/preview" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"{ "ok": true, "page": 1, "pageCount": 2, "pages": [ { "content": "iVBORw0KGgo=", "mime": "image/png" } ]}Anhang als Beleg übernehmen POST
Übernimmt einen Anhang als Beleg, wie „Übernehmen“ in der App: bimetrics speichert die Datei, erkennt und bucht sie wie üblich, und sie zählt zum Kontingent. Hat die Firma diese Datei schon, entsteht kein zweiter Beleg (`duplicate`). Ein schon übernommener Anhang liefert seinen Beleg (`alreadyImported`). Ein nicht vorgeschlagener Anhang (`preselected` = `false`) ist meist die zweite Fassung derselben Rechnung, etwa die XML neben ihrem ZUGFeRD-PDF: Beide zu übernehmen legt die Rechnung zweimal an. Wartet kein vorgeschlagener Anhang mehr, wandert die Mail nach „Erledigt“ (`mailArchived`). Abgelehnt: eine Mail unter „Erledigt“ (`409 InboxMailArchived`, erst zurückholen), ein Anhang, den bimetrics nicht lesen kann (`409 InboxAttachmentNotImportable`), ein Anhang, dessen Beleg inzwischen gelöscht ist (`409 InboxAttachmentDocumentDeleted`), und bei vielen wartenden Belegen `429 DocumentQueueFull` mit `Retry-After`. Eine Wiederholung mit gleichem Idempotency-Key legt nichts doppelt an. Benötigt einen Schlüssel mit der Berechtigung `inbox:write`.
Mail zurückholen POST
Holt eine Mail von „Erledigt“ nach „Offen“, wie „Zurückholen“ in der App. Erst dann lassen sich weitere Anhänge übernehmen. Benötigt einen Schlüssel mit der Berechtigung `inbox:write`.