Von Resend zu Truncus migrieren

Die meisten Migrationen dauern unter 30 Minuten. Die API-Struktur ist ähnlich — die wichtigsten Unterschiede sind EU-Datenresidenz, Pflicht-Idempotenzschlüssel und der Sandbox-Modus.

Schritt 1 — API-Schlüssel erstellen

1. Registrieren Sie sich auf truncus.co
2. Dashboard → Einstellungen → API-Schlüssel → Erstellen
3. Kopieren Sie Ihren tr_live_... Schlüssel

Schritt 2 — Domain verifizieren

Der Domain-Verifizierungsprozess ist identisch mit Resend. Gehen Sie zu Dashboard → Domains, fügen Sie Ihre Domain hinzu und kopieren Sie die drei DNS-Einträge (SPF, DKIM, DMARC).

Schritt 3 — Code aktualisieren

Vorher (Resend):

import { Resend } from 'resend';
const resend = new Resend(process.env.RESEND_API_KEY);

await resend.emails.send({
  from: 'hello@mail.ihredomain.com',
  to: 'user@example.com',
  subject: 'Willkommen!',
  html: '<p>Hallo!</p>',
});

Nachher (Truncus):

import { Truncus } from '@truncus/email';
const truncus = new Truncus({ apiKey: process.env.TRUNCUS_API_KEY });

await truncus.sendEmail({
  from: 'hello@mail.ihredomain.com',
  to: 'user@example.com',
  subject: 'Willkommen!',
  html: '<p>Hallo!</p>',
  // idempotencyKey wird automatisch generiert
});

API-Mapping

Resend	Truncus	Hinweise
POST /emails	POST /api/v1/emails/send	Idempotency-Key Header erforderlich
GET /emails/:id	GET /api/v1/emails/:id	Gleiche Struktur
POST /batch	POST /api/v1/emails/batch	Max. 100 pro Anfrage
GET /domains	GET /api/v1/domains	Gleich
n/a	POST /api/v1/emails/validate	Nur Truncus: Dry-Run-Validierung

Wichtige Unterschiede

Idempotency-Key Header (Pflicht)

Truncus erfordert einen Idempotency-Key Header bei jeder Send-Anfrage. Die Node.js- und Python-SDKs generieren automatisch eine UUID v4, wenn Sie keinen angeben.

Sandbox-Modus

Fügen Sie X-Truncus-Sandbox: true zu jeder Anfrage hinzu für einen vollständigen Dry-Run:

curl -X POST https://truncus.co/api/v1/emails/send \
  -H "Authorization: Bearer $TRUNCUS_API_KEY" \
  -H "X-Truncus-Sandbox: true" \
  -H "Idempotency-Key: test-$(uuidgen)" \
  -d '{ "to": "...", "from": "...", "subject": "...", "html": "..." }'

Umgebungsvariablen

# Entfernen
RESEND_API_KEY=re_xxx

# Hinzufügen
TRUNCUS_API_KEY=tr_live_xxx

Hilfe benötigt?

E-Mail an hello@truncus.co oder öffnen Sie den Chat in Ihrem Dashboard.