VookMail Entwickler-API
Erstelle temporäre Postfächer und lies Nachrichten aus deinen eigenen Apps über eine einfache REST-API. Die Antworten sind JSON.
Authentifizierung
Sende deinen API-Schlüssel im Authorization-Header. Die Schlüssel werden vom Betreiber der Seite ausgestellt.
curl https://www.vookmail.com/api/v1/domains \
-H "Authorization: Bearer vk_your_key"Endpunkte
Basis-URL: https://www.vookmail.com/api/v1
| Methode | Pfad | Beschreibung |
|---|---|---|
| GET | /domains | Verfügbare Domains auflisten |
| POST | /mailboxes | Ein Postfach erstellen. Body: Benutzername und Domain, beides optional |
| GET | /mailboxes/{address} | Postfach-Details und Ablauf |
| POST | /mailboxes/{address}/extend | Lebensdauer des Postfachs verlängern |
| DELETE | /mailboxes/{address} | Postfach schließen und seine Nachrichten löschen |
| GET | /mailboxes/{address}/messages?after={id} | Nachrichten auflisten, mit erkannten Codes und Links |
| GET | /mailboxes/{address}/messages/{id} | Eine Nachricht lesen: bereinigtes HTML, Text und Anhänge |
| DELETE | /mailboxes/{address}/messages/{id} | Eine Nachricht löschen |
| GET | /mailboxes/{address}/messages/{id}/attachments/{attachment} | Einen Anhang herunterladen |
Beispiel
curl -X POST https://www.vookmail.com/api/v1/mailboxes \
-H "Authorization: Bearer vk_your_key" \
-H "Content-Type: application/json" \
-d '{"username":"myapp"}'
{"address":"myapp@example.com","token":"...","expires_at":"2026-10-31T12:00:00+00:00"}Fehler und Limits
Fehler liefern einen HTTP-Status mit error.code und error.message. Jeder Schlüssel hat ein Limit pro Minute; wird es überschritten, kommt der Status 429.