Zum Inhalt springen
Doku

Referenz

SDKs und Bibliotheken

Offizielle Emailit-Bibliotheken für Node.js, PHP, Laravel, Python, Ruby, Go, Java, .NET und Rust, dazu das MCP-Paket und wie Sie die API direkt per HTTP aufrufen.

Aktualisiert am 1. Okt. 2026

Emailit pflegt Open-Source-Client-Bibliotheken für neun Sprachen und Frameworks. Jede kapselt die REST-API mit typisierten Fehlern und denselben Ressourcennamen wie in der API-Referenz. Wenn Ihre Sprache nicht aufgeführt ist, funktioniert jeder HTTP-Client.

Offizielle Bibliotheken

Alle Bibliotheken stehen unter der MIT-Lizenz und werden über github.com/emailit veröffentlicht.

Sprache Paket Installation Voraussetzung Quellcode
Node.js @emailit/node npm install @emailit/node Node.js 18+ emailit-node
PHP emailit/emailit-php composer require emailit/emailit-php PHP 8.1+ emailit-php
Laravel emailit/emailit-laravel composer require emailit/emailit-laravel Laravel 10, 11 oder 12 emailit-laravel
Python emailit pip install emailit Python 3.7+ emailit-python
Ruby emailit bundle add emailit Ruby 3.0+ emailit-ruby
Go github.com/emailit/emailit-go/v2 go get github.com/emailit/emailit-go/v2 Go 1.21+ emailit-go
Java com.emailit:emailit-java Maven oder Gradle, siehe unten Java 11+ emailit-java
.NET Emailit dotnet add package Emailit .NET 8+ emailit-dotnet
Rust emailit cargo add emailit Rust 1.85+ und Tokio emailit-rust

Fügen Sie für Java die Abhängigkeit mit der neuesten Version aus dem Repository hinzu:

pom.xml
<dependency>
  <groupId>com.emailit</groupId>
  <artifactId>emailit-java</artifactId>
  <version>VERSION</version>
</dependency>
build.gradle
implementation 'com.emailit:emailit-java:VERSION'

E-Mail senden

Jede Bibliothek erhält Ihren API-Schlüssel, wenn Sie den Client erstellen. Laden Sie ihn aus einer Umgebungsvariable, statt ihn fest in den Code zu schreiben.

JavaScript
import { Emailit } from '@emailit/node';

const emailit = new Emailit(process.env.EMAILIT_API_KEY);

const email = await emailit.emails.send({
  from: 'Acme <hello@acme.com>',
  to: 'ada@example.com',
  subject: 'Welcome to Acme',
  html: '<p>Thanks for signing up.</p>',
});

console.log(email.id);

Die Adresse in from muss auf einer verifizierten Versanddomain liegen. Bis Ihr Workspace Produktionszugang hat, können Sie nur an die Konto-E-Mail-Adressen der Mitglieder des Workspaces senden.

Was die Bibliotheken abdecken

Jede Bibliothek bietet dieselben Services: E-Mails, Domains, API-Schlüssel, Kontaktlisten, Abonnenten, Vorlagen, Sperrungen, E-Mail-Verifizierungen, Verifizierungslisten, Webhooks, Kontakte und Events. Fehler werden als typisierte Exceptions oder Fehlerwerte ausgegeben, zum Beispiel ein Authentifizierungsfehler bei 401, ein Rate-Limit-Fehler bei 429 und ein Validierungsfehler bei 422, sodass Sie jeden Fall getrennt behandeln können.

Einige neuere Endpunkte sind noch nicht gekapselt, darunter das Weiterleiten einer E-Mail, Kampagnen, Automatisierungen, Formulare und DMARC-Berichte. Außerdem setzen die Bibliotheken den Header Idempotency-Key nicht. Rufen Sie diese Endpunkte per HTTP mit demselben API-Schlüssel auf, wie unten gezeigt.

Die Einrichtung für einzelne Frameworks, einschließlich Mail-Transports, Webhook-Routen und SMTP-Konfiguration, finden Sie in den Framework-Anleitungen: Node.js, Next.js, Nuxt, Laravel, PHP, Python, Ruby on Rails, Go, Java, .NET und WordPress.

Paket für den MCP-Server

Das Open-Source-Paket @emailit/emailit-mcp führt einen MCP-Server auf Ihrem Rechner aus, damit KI-Assistenten Emailit mit Ihrem API-Schlüssel aufrufen können:

Terminal
npx -y @emailit/emailit-mcp

Die meisten brauchen es nicht: Der gehostete Server unter https://api.emailit.com/mcp erfordert keine Installation. Einen Vergleich der beiden finden Sie unter MCP-Server lokal ausführen.

@emailit/js ist ein anderes Paket: Es ist das Browser-Skript, das Emailit-Formulare auf Ihrer Website anzeigt, kein API-Client.

API per HTTP nutzen

Sie brauchen keine Bibliothek. Jeder HTTP-Client, der JSON senden kann, funktioniert:

  • Basis-URL: https://api.emailit.com/v2
  • Header: Authorization: Bearer <your API key> und Content-Type: application/json
  • Anfrage-Bodys und Antworten: JSON

So leiten Sie zum Beispiel eine E-Mail mit einem Idempotenzschlüssel aus Node.js ohne das SDK weiter:

JavaScript
const response = await fetch('https://api.emailit.com/v2/emails/em_4K6oASS7KP9ztzWmSN9ndEu13HW/forward', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.EMAILIT_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': 'forward-order-1042',
  },
  body: JSON.stringify({ to: 'support@acme.com' }),
});

if (!response.ok) {
  throw new Error(`Emailit returned ${response.status}: ${await response.text()}`);
}

Lesen Sie Fehler und Rate Limits, bevor Sie Ihren eigenen Client entwickeln, damit Sie Antworten mit 4xx und retry-after richtig behandeln. Wenn Ihre App bereits SMTP spricht, können Sie die API auch ganz weglassen und das SMTP-Relay verwenden.

Bibliotheken aus der Community

Emailit pflegt keine Bibliotheken außer denen in der Liste oben. Wenn Sie eine für eine andere Sprache oder ein anderes Framework finden oder entwickeln, prüfen Sie ihren Code, bevor Sie ihr einen API-Schlüssel geben, und verwenden Sie möglichst einen Schlüssel mit Sending Only, der auf eine Domain beschränkt ist. Schreiben Sie uns an support@emailit.com oder auf Discord, wenn sie hier erwähnt werden soll.

Basis-URL, IDs, Fehler, Paginierung und Rate Limits.
Den Schlüssel erstellen, den Ihre Bibliothek braucht.
Vorlagen, Anhänge, Planung und Tracking.
Prüfen, ob Webhook-Anfragen von Emailit stammen.

War diese Seite hilfreich?

Danke für Ihr Feedback.

Danke, wir lesen jede Nachricht.