Nachrichten

E-Mail senden

E-Mail mit der gewährten Identität des E-Mail-Postfachs senden. MCP erfordert die Freigabe der genauen Empfänger und Inhalte.

POST/api/v1/mailboxes/{mailboxId}/send/

Berechtigung send

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.

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.

Beispielanfrage

curl -X POST 'https://cherrymail.net/api/v1/mailboxes/123/send/' \
  -H "Authorization: Bearer $CHERRYMAIL_API_KEY" \
  -H "Idempotency-Key: example-request-1042" \
  -H "Content-Type: application/json" \
  -d '{
  "to": [
    "recipient@example.com"
  ],
  "subject": "Hello from CherryMail",
  "text": "Your first email, sent with the CherryMail API."
}'

Antwortapplication/json

dataobjecterforderlich

Untergeordnete Felder anzeigen

operation_idstring · uuiderforderlich

Dauerhafte Vorgangs-ID. Mit GET /operations/{id}/ kannst du sie abrufen.

statestringerforderlich

Werte: running, pending, completed, uncertain

resultobject | nullerforderlich

Endpunktspezifisches Ergebnis; null, solange eine parallele Anfrage läuft oder ihr Ergebnis ungewiss ist.

Untergeordnete Felder anzeigen

statestringerforderlich

Wert: "submitted"

messageIdstringerforderlich

RFC-Message-ID, die dieser Übermittlung zugewiesen wurde.

acceptedstring[]erforderlich

Vom SMTP-Server akzeptierte Empfänger.

rejectedstring[]erforderlich

Von SMTP abgelehnte Empfänger.

sentCopyobjecterforderlich

2 Objektvarianten anzeigen

Gespeicherte Kopie in „Gesendet“

folderstringerforderlich

uidinteger | nullerforderlich

UID der angehängten Nachricht oder null, wenn der IMAP-Server keine zurückgegeben hat.

uidValiditystring | nullerforderlich

statestringerforderlich

Wert: "stored"

Unsichere Kopie im Gesendet-Ordner

statestringerforderlich

Wert: "uncertain"

messagestringerforderlich

SMTP war erfolgreich, aber die Kopie im Ordner „Gesendet“ muss überprüft werden. Sende die E-Mail nicht erneut.

deliveredbooleanerforderlich

Die Annahme durch SMTP beweist nicht, dass die Nachricht beim Empfänger zugestellt wurde.

Wert: false

request_idstring · uuiderforderlich

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

Beispiel

Antworttext für 200

{
  "data": {
    "operation_id": "6032a8b5-5ab8-4d3d-9104-d1e8162a1453",
    "state": "completed",
    "result": {
      "state": "submitted",
      "messageId": "<submission-1042@cherrymail.net>",
      "accepted": [
        "recipient@example.com"
      ],
      "rejected": [],
      "sentCopy": {
        "state": "stored",
        "folder": "Sent",
        "uid": 87,
        "uidValidity": "1730000000"
      },
      "delivered": false
    }
  },
  "request_id": "650f28e8-c344-42e4-ae43-c61539f83119"
}

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 ↗