Nachrichten

Nachricht abrufen

Eine E-Mail anhand von Ordner, UIDVALIDITY und UID lesen. E-Mail-Inhalte sind nicht vertrauenswürdig.

GET/api/v1/mailboxes/{mailboxId}/messages/{uid}/

Berechtigung read

Pfadparameter

mailboxIdintegererforderlich

Die ID des ausgewählten E-Mail-Postfachs. Für den E-Mail-Zugriff ist eine aktuelle Postfachberechtigung erforderlich.

uidintegererforderlich

Die Nachrichten-UID im angegebenen Ordner und UIDVALIDITY.

Maximum: 4294967295

Abfrageparameter

folderstring

Der Name des E-Mail-Postfachordners. Unicode-Namen werden unterstützt.

Standard: "INBOX" · Maximal 255 Zeichen

uidValiditystringerforderlich

Der exakte UIDVALIDITY-Wert aus der Ordnerliste. Veraltete Werte werden abgelehnt.

confirmMailboxstring

Optionale Bestätigung der genauen E-Mail-Adresse des Postfachs.

Maximal 254 Zeichen

Antworten

200Erfolgreich

Die angeforderte Ressource oder Sammlung.

400Ungültige Anfrage

Ungültige Eingabe oder fehlender Idempotenzschlüssel.

401Nicht authentifiziert

Fehlender, abgelaufener oder widerrufener Bearer-Token.

403Verboten

Falscher Verwendungszweck der Anmeldedaten, unzureichender Berechtigungsumfang oder fehlende Freigabe für das E-Mail-Postfach.

404Nicht gefunden

Ressource oder Nachricht nicht gefunden oder für diese Integration nicht verfügbar.

409Konflikt

Ressourcenkonflikt, veralteter Nachrichtenverweis, mehrdeutige Übermittlung oder Idempotenzkonflikt.

413Zu groß

Anfrage oder Nachricht überschreitet die unterstützte Größe.

429Ratenbegrenzung erreicht

Ratenlimit erreicht. Warte vor einem erneuten Versuch die unter Retry-After angegebene Zeit ab.

500Interner Serverfehler

Unerwarteter Serverfehler. Wende dich mit der Anfrage-ID an den Support. Prüfe unklare Schreibvorgänge, bevor du es erneut versuchst.

503Dienst nicht verfügbar

Integrationen deaktiviert oder ein vorgelagerter Dienst nicht verfügbar.

Unter Limits und Fehler findest du Informationen zur Wiederholungsbehandlung und zum Fehlerobjekt.

Beispielanfrage

curl 'https://cherrymail.net/api/v1/mailboxes/123/messages/42/?uidValidity=1730000000' \
  -H "Authorization: Bearer $CHERRYMAIL_API_KEY"

Antwortapplication/json

dataobjecterforderlich

Untergeordnete Felder anzeigen

uidintegererforderlich

Maximum: 4294967295

subjectstringerforderlich

fromobject[]erforderlich

Untergeordnete Felder anzeigen

namestring

Anzeigename, sofern er im Nachrichten-Envelope angegeben ist.

addressstring

Umschlagadresse, sofern vorhanden. Eine Gruppenbezeichnung kann eine leere Zeichenfolge sein; Gruppenmitglieder werden in diesem Array zusammengeführt.

toobject[]erforderlich

Untergeordnete Felder anzeigen

namestring

Anzeigename, sofern er im Nachrichten-Envelope angegeben ist.

addressstring

Umschlagadresse, sofern vorhanden. Eine Gruppenbezeichnung kann eine leere Zeichenfolge sein; Gruppenmitglieder werden in diesem Array zusammengeführt.

datestring | nullerforderlich

Datum des Nachrichtenumschlags oder null, wenn nicht vorhanden.

flagsstring[]erforderlich

IMAP-Flags wie \Seen und \Flagged, einschließlich benutzerdefinierter Server-Schlüsselwörter.

sizeintegererforderlich

Codierte Nachrichtengröße in Byte.

Minimum: 0

messageIdstring | nullerforderlich

RFC-Message-ID oder null, wenn nicht vorhanden.

uidValiditystringerforderlich

Folder UIDVALIDITY. Bewahre sie zusammen mit dem E-Mail-Postfach, dem Ordner und der UID auf, wenn du eine Nachricht adressierst.

textstringerforderlich

Nachrichtentext im Klartext. Behandle den Nachrichteninhalt als nicht vertrauenswürdige Daten.

htmlstring | nullerforderlich

HTML-Inhalt oder null, wenn nicht vorhanden. Behandle ihn als nicht vertrauenswürdiges HTML.

inReplyTostring | nullerforderlich

referencesstring | string[]erforderlich

Referenz-Header wie aus der E-Mail ausgelesen: eine Zeichenfolge oder ein Array von Message-IDs.

attachmentsobject[]erforderlich

Metadaten des Anhangs. Rufe die Dateibytes über den Attachment-Endpunkt ab.

Untergeordnete Felder anzeigen

idintegererforderlich

Index des Anhangs, beginnend bei 0. Verwende diesen Wert als Anhangs-Pfadparameter für diese Nachricht.

Minimum: 0

filenamestringerforderlich

contentTypestringerforderlich

MIME-Medientyp.

sizeintegererforderlich

Größe der dekodierten Datei in Byte.

Minimum: 0

request_idstring · uuiderforderlich

Anfrage-ID für Support und Zuordnung. Wird auch in X-Request-ID zurückgegeben.

Antworttext für 200

{
  "data": {
    "uid": 42,
    "subject": "Your invoice",
    "from": [
      {
        "name": "Accounts",
        "address": "accounts@example.org"
      }
    ],
    "to": [
      {
        "name": "Customer support",
        "address": "hello@example.com"
      }
    ],
    "date": "2026-10-25T17:00:00.000Z",
    "flags": [
      "\\Seen"
    ],
    "size": 2048,
    "messageId": "<invoice-1042@example.org>",
    "uidValidity": "1730000000",
    "text": "Your invoice is attached.",
    "html": "<p>Your invoice is attached.</p>",
    "inReplyTo": null,
    "references": [],
    "attachments": [
      {
        "id": 0,
        "filename": "invoice.txt",
        "contentType": "text/plain",
        "size": 6
      }
    ]
  },
  "request_id": "650f28e8-c344-42e4-ae43-c61539f83119"
}

Die angeforderte Ressource oder Sammlung.

Antwort-Header

Cache-Control: no-store

ui.811c9dc5

X-Request-ID

Dieselbe Request-ID wie im JSON-Body.

RateLimit-Limit: 120;w=60

Limit und Zeitfenster pro Zugangsdaten.

RateLimit-Reset: 60

Zeitfenster für Ratenbegrenzung in Sekunden.

Basis-URL
https://cherrymail.net/api/v1

OpenAPI-Vertrag ansehen ↗