CherryMail
Zur Dokumentation springen
Entwicklerv1

Dokumentation ansehen

ÜbersichtAnleitungenSchnellstartAnleitungenAuthentifizierungAnleitungenLimits & FehlerAnleitungenWebhooksAnleitungenMCP-VerbindungenAnleitungenKonto abrufenKonto · GET /account/Domains auflistenDomains · GET /domains/Domain erstellenDomains · POST /domains/Eine Domain abrufenDomains · GET /domains/{id}/Domain löschenDomains · DELETE /domains/{id}/DNS-Anweisungen abrufenDomains · GET /domains/{id}/dns/
CherryMail-Entwicklerdokumentation durchsuchen
Entwickler /API-Referenz/ Nachrichten
Nachrichten

Nachricht löschen

Verschiebe die E-Mail in den Papierkorb oder lösche sie dauerhaft, wenn permanent true ist. MCP erfordert eine Genehmigung.

DELETE/api/v1/mailboxes/{mailboxId}/messages/{uid}/
Berechtigung delete
MCP-Aktionen erfordern eine Genehmigung
Bei einem Aufruf über MCP gibt dieser Vorgang einen einmalig verwendbaren Genehmigungslink zurück. Prüfe die genaue Aktion und genehmige sie innerhalb von zehn Minuten in CherryMail.

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.

Request-Header

Idempotency-Keystringerforderlich

Ein eindeutiger Schlüssel für diese beabsichtigte Aktion. Verwende ihn nur mit denselben Anfrageeingaben erneut.

Maximal 128 Zeichen

Anfragetext

Sende JSON mit Content-Type: application/json.

confirmMailboxstring

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

Maximal 254 Zeichen

permanentboolean

False verschiebt eine Nachricht in den Papierkorb. True löscht sie endgültig.

Standard: false

Antworten

200Erfolgreich

Dauerhafter Vorgangsbeleg mit dem Ergebnis dieses Endpunkts. Ausstehende Bereitstellung und SMTP-Annahme sind nicht gleichbedeutend mit der Bereitschaft der Ressource oder der Zustellung an den Empfänger.

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.