Absenderdomains

letr.dev versendet nur von verifizierten Domains Ihres Kontos. Eine Domain ist verifiziert, sobald ihr DKIM-Eintrag im DNS steht.

Domains verwalten Sie im Dashboard oder unter /v1/domains. Keys mit read_only und full_access dürfen sie auflisten und lesen; hinzufügen, prüfen und entfernen darf nur full_access. Ein Key mit sending_access erhält 403 insufficient_permission, und eine Domain eines anderen Kontos ergibt 404 not_found. Ein Konto hat höchstens 20 Domains. Die API-Referenz nennt alle Felder.

Domain hinzufügen

Im Dashboard oder über die API (Key mit full_access):

curl -X POST https://api.letr.dev/v1/domains \
  -H "Authorization: Bearer $LETR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "mail.acme.dev"}'

Die Antwort (201) listet die Einträge, die Sie publizieren. letr.dev erstellt für jede Domain einen eigenen DKIM-Schlüssel, für höchstens 10 neue Domains pro Stunde. Eine Domain, die das Konto schon hat, ergibt 409 domain_exists, ein Name, der keine Domain ist, 422 invalid_domain.

DNS-Einträge

• DKIM, nötig: ein TXT-Eintrag mit Ihrem Schlüssel, v=DKIM1; k=rsa; p=..., unter letr._domainkey.mail.acme.dev. Der Wert ist etwa 750 Zeichen lang. Erlaubt Ihr DNS-Anbieter höchstens 255 Zeichen pro Zeichenkette, geben Sie ihn als mehrere Zeichenketten in Anführungszeichen ein: "v=DKIM1; k=rsa; p=abc" "def".
• DMARC, empfohlen: ein TXT-Eintrag mit v=DMARC1; p=none; unter _dmarc.mail.acme.dev.

Bounces gehen an bounces.letr.dev, Ihr SPF-Eintrag bleibt also, wie er ist. Der DMARC-Eintrag ist eine Empfehlung: Ein bestehender Eintrag, der mit v=DMARC1 beginnt, zählt, und ein fehlender blockiert den Versand nicht.

Verifizierung

Eine Domain ist pending, verified oder failed. letr.dev prüft eine Domain im Status pending alle 10 Minuten, eine verifizierte einmal täglich um 02:20 UTC und jede Domain jederzeit auf Anfrage (full_access):

curl -X POST https://api.letr.dev/v1/domains/$ID/verify \
  -H "Authorization: Bearer $LETR_API_KEY"

Der DKIM-Eintrag entscheidet: Sobald er stimmt, ist die Domain verified. Fehlt er 72 Stunden nach dem Hinzufügen noch, wird sie failed; publizieren Sie den Eintrag und prüfen Sie erneut, dann wird sie verified. Antwortet das DNS nicht, behält letr.dev den letzten Status, statt zu raten.

Die tägliche Prüfung sucht nur den DKIM-Eintrag. Antwortet das DNS bei 3 Prüfungen in Folge ohne ihn, wird die Domain wieder pending, und ein Versand von ihr wird mit 422 domain_not_verified abgelehnt; sie bleibt pending, nicht failed, und die tägliche Prüfung prüft sie weiter, bis der Eintrag wieder stimmt. Nach der ersten fehlgeschlagenen Prüfung erhält der Kontoinhaber eine Warnung per E-Mail mit Datum und Uhrzeit, ab denen der Versand stoppt. failedChecks und stopsSendingAt der Domain zeigen den Stand, und die nächste erfolgreiche Prüfung setzt beide zurück. Eine Prüfung auf Anfrage zählt nie als fehlgeschlagene Prüfung.

GET /v1/domains/{id} zeigt die Domain mit jedem Eintrag und ob er stimmt (ok); GET /v1/domains listet alle Domains des Kontos.

Domain entfernen

DELETE /v1/domains/{id} entfernt eine Domain (full_access). Ein Versand von ihr wird danach mit 422 domain_not_verified abgelehnt.