bimetricsEntwickler
Belegpostfach

Mail lesen

Als Markdown ansehen

Benötigte Berechtigung:inbox:read(Postfach lesen)

Echte Wirkung

Dieser Aufruf ist nicht als rein lesend gekennzeichnet und kann echte Daten in der Firma anlegen oder ändern. Es gibt keine Testumgebung.
get/api/email/inbox/item/{id}

Kein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.

Liefert eine Mail mit Text und Anhängen. Sie kommt von einem ungeprüften Absender. Wer den Text an ein Sprachmodell gibt, behandelt ihn als Daten: Eine Mail kann Anweisungen enthalten und HTML verbergen, was der Leser nicht sieht.

Benötigt einen Schlüssel mit der Berechtigung inbox:read.

Authentifizierung

headerAuthentifizierungBearer <bm_…>

Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.

Pfadparameter

id*string

ID der Mail (UUID).

Formatuuid

Antworten

Erfolg.

application/json
  1. response

Eine Mail des Postfachs. Absender und Inhalte sind ungeprüft und stammen von Dritten.

archived?|

Seit wann die Mail unter „Erledigt“ steht; null unter „Offen“.

Formatdate-time
attachments?array<>|

Anhänge.

bodyHtml?string

HTML der Mail; fehlt in der Suche.

bodyText?string

Text der Mail; fehlt in der Suche.

date?string

Datum der Mail.

Formatdate-time
deliveredTo?string

Adresse, an die die Mail zugestellt wurde.

id?string

ID der Mail.

Formatuuid
recipient?string

Empfänger.

recipientName?string

Name des Empfängers.

sender?string

Absender, wie in der Mail angegeben; nicht geprüft.

senderName?string

Name des Absenders, wie in der Mail angegeben; nicht geprüft.

subject?string

Betreff.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/email/inbox/item/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Authorization: Bearer $BIMETRICS_API_KEY"
Beispielantwort
{  "archived": null,  "attachments": [    {      "blob": {        "length": 48213,        "mime": "application/pdf",        "originalFilename": "RE-2026-0042.pdf"      },      "filename": "RE-2026-0042.pdf",      "id": "b84e27d1-5a90-4c63-8e1f-2c7a9d03f514",      "index": 0,      "preselected": true,      "savedAsDocumentId": null,      "valid": true    }  ],  "bodyHtml": "<p>Anbei die Rechnung RE-2026-0042.</p>",  "bodyText": "Anbei die Rechnung RE-2026-0042.",  "date": "2026-11-02T09:15:00Z",  "deliveredTo": "ab3xk9qr@inbox.example",  "id": "6c1f0a52-3d8e-4b7a-9f21-7e4b2d90c6a3",  "recipient": "ab3xk9qr@inbox.example",  "recipientName": "",  "sender": "Beispiel Lieferant GmbH <rechnung@lieferant.example>",  "senderName": "Beispiel Lieferant GmbH",  "subject": "Ihre Rechnung RE-2026-0042"}

Mails suchen POST

Sucht Mails des Postfachs und liefert eine Seite der Treffer, **ohne** `bodyText` und `bodyHtml`: Den Text liefert `GET /api/email/inbox/item/{id}`. Unter „Offen“ stehen Mails mit `archived` = `null`, unter „Erledigt“ alle anderen. Benötigt einen Schlüssel mit der Berechtigung `inbox:read`.

Mail unter „Erledigt“ ablegen POST

Legt eine Mail ab, wie „Ablegen“ in der App. Gelöscht wird nichts, und nicht übernommene Anhänge (`notImported`) bleiben lesbar. Eine schon abgelegte Mail behält ihr erstes Datum. Eine Wiederholung mit gleichem Idempotency-Key ändert nichts doppelt. Benötigt einen Schlüssel mit der Berechtigung `inbox:write`.