Erste Schritte mit der API
Die EvilMail-API ermoglicht es Ihnen, die Verwaltung Ihrer temporaren E-Mails direkt aus Ihrer Anwendung heraus zu automatisieren. Ob Sie ein Testtool, ein Verifizierungssystem oder eine Automatisierungsplattform entwickeln -- die REST-API bietet Ihnen vollstandigen Zugriff auf alle Funktionen von EvilMail.
Ihren API-Schlussel erhalten
Um die API zu nutzen, mussen Sie zunachst einen API-Schlussel in Ihrem EvilMail-Dashboard generieren. Gehen Sie zu Einstellungen > API und klicken Sie auf „Neuen Schlussel generieren". Bewahren Sie diesen Schlussel sicher auf: Er wird im Authorization-Header jeder Anfrage mitgesendet.
Authorization: Bearer YOUR_API_KEYTemporare E-Mail erstellen
Um eine neue temporare E-Mail-Adresse zu erstellen, senden Sie eine POST-Anfrage an den entsprechenden Endpoint:
curl -X POST https://evilmail.com/api/temp-email
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{"domain": "example.com", "prefix": "test", "ttl": 3600}'Die Antwort enthalt die generierte E-Mail-Adresse, ihr Ablaufdatum und eine eindeutige Kennung. Der Parameter ttl (Time-to-Live) legt die Lebensdauer der Adresse in Sekunden fest.
Posteingang auslesen
Um die empfangenen E-Mails einer temporaren Adresse einzusehen, fuhren Sie eine GET-Anfrage aus:
curl -X GET https://evilmail.com/api/inbox/[email protected]
-H "Authorization: Bearer YOUR_API_KEY"Die Antwort enthalt die Liste der Nachrichten mit Absender, Betreff, Inhalt (Text und HTML), Anhangen und Zeitstempeln. Sie konnen Nachrichten auch nach Datum oder Absender mithilfe von Abfrageparametern filtern.
Domain-Verwaltung
Die API ermoglicht es Ihnen auch, Ihre benutzerdefinierten Domains programmatisch zu verwalten:
# Domains auflisten
curl -X GET https://evilmail.com/api/domains
-H "Authorization: Bearer YOUR_API_KEY"
# Domain hinzufugen
curl -X POST https://evilmail.com/api/domains
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{"domain": "meinedomain.com"}'
# DNS-Status prufen
curl -X GET https://evilmail.com/api/domains/meinedomain.com/status
-H "Authorization: Bearer YOUR_API_KEY"Haufige Anwendungsfalle
- Automatisierte Tests: Erstellen Sie eindeutige Adressen fur jeden Testdurchlauf und uberprufen Sie den Empfang transaktionaler E-Mails.
- Benutzerverifizierung: Integrieren Sie die Erstellung temporarer E-Mails in Ihre Registrierungsablaufe fur Benutzer, die ihre Hauptadresse nicht angeben mochten.
- Monitoring: Richten Sie regelmaessige Zustellbarkeitsprufungen ein, indem Sie Testnachrichten an temporare Adressen senden und deren Empfang verifizieren.
- Datenschutz: Bieten Sie Ihren Benutzern die Moglichkeit, Wegwerfadressen direkt aus Ihrer Anwendung heraus zu generieren.
Fehlerbehandlung und Limits
Die API verwendet standardmaessige HTTP-Statuscodes. Haufige Fehler sind 401 (ungultiger API-Schlussel), 404 (Adresse oder Domain nicht gefunden) und 429 (Rate-Limit erreicht). Schlagen Sie in der API-Dokumentation nach, um die Rate-Limits und Best Practices fur die Integration zu erfahren.