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/ Entwürfe
Entwürfe

Entwurf erstellen

Entwurf speichern, ohne ihn zu senden.

POST/api/v1/mailboxes/{mailboxId}/drafts/
Berechtigung write

Pfadparameter

mailboxIdintegererforderlich

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

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.

fromstring

Absenderidentität. Muss exakt mit der freigegebenen E-Mail-Postfachadresse übereinstimmen.

Maximal 254 Zeichen

tostring[]erforderlich

E-Mail-Adressen der Empfänger. An, Cc und Bcc dürfen zusammen höchstens 20 Adressen enthalten.

ccstring[]

Empfänger in Kopie.

bccstring[]

Empfänger im Blindkopiefeld.

subjectstringerforderlich

Der E-Mail-Betreff ohne Steuerzeichen.

Maximal 998 Zeichen

textstringerforderlich

Textkörper der Nachricht im Klartext.

Maximal 1000000 Zeichen

htmlstring

Optionaler HTML-Nachrichteninhalt.

Maximal 1000000 Zeichen

attachmentsobject[]

Einzuschließende Dateien. Bis zu 10 Anhänge und insgesamt 5 MiB dekodierte Daten.

Untergeordnete Felder anzeigen
filenamestringerforderlich

Der Dateiname des Anhangs.

Maximal 180 Zeichen

contentTypestringerforderlich

Der MIME-Medientyp, zum Beispiel application/pdf.

Maximal 120 Zeichen

contentstringerforderlich

Die als Base64 codierten Dateibytes.

Maximal 7000000 Zeichen

inReplyTostring

Message-ID für die Gruppierung von Antworten.

Maximal 998 Zeichen

referencesstring[]

Message-ID-Referenzkette für die Gruppierung von Nachrichten.

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.