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/ Alias-Adressen
Alias-Adressen

Alias-Adresse erstellen

Eine Weiterleitungs-Alias-Adresse für eine verifizierte Domain erstellen.

POST/api/v1/aliases/
Berechtigung write

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.

domainintegererforderlich

Domainname beim Reservieren einer Domain; Domain-ID beim Erstellen eines E-Mail-Postfachs oder einer Alias-Adresse.

localPartstringerforderlich

Der Teil der E-Mail-Adresse vor dem @-Zeichen.

Maximal 64 Zeichen

destinationsstring[]erforderlich

E-Mail-Adressen, an die E-Mails weitergeleitet werden, die dieser Alias-Adresse zugestellt werden.

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.