Developer Center

Once Email API-Dokumentation

Öffentliche Dokumentation für automatisierte E-Mail-Tests: Authentifizierung, Kontingente, Fehler und sichere Nutzung.

Die Dokumentation ist öffentlich. API-Schlüssel gibt es nur mit aktivem Developer-Abo und sie werden im Dashboard verwaltet.
Authentifizierung

Sende bei jeder Anfrage Authorization: Bearer oe_live_…. Ein Schlüssel wird einmal angezeigt; speichere ihn im Secret Manager, nie in Browsercode, Logs oder Git.

Authorization: Bearer oe_live_your_key
Typischer Ablauf
  1. 1Erstelle ein temporäres Postfach und behalte seine ID.
  2. 2Lass dein Testsystem eine E-Mail dorthin senden.
  3. 3Frage die Nachrichtenliste mit Backoff ab; vermeide schnelle Leerabfragen.
  4. 4Lies die Zielnachricht, prüfe das Ergebnis und lösche das Postfach.

Private-Beta-Endpunkte

POST /v1/inboxesGET /v1/inboxes/{inboxId}/messagesGET /v1/inboxes/{inboxId}/messages/{uid}GET /v1/inboxes/{inboxId}/messages/{uid}/attachments/{cid}DELETE /v1/inboxes/{inboxId}

Statuscodes

400

Ungültige Anfrage

401

Schlüssel fehlt oder ist ungültig

403

Tarif oder Ressource verweigert

404

Ressource nicht gefunden

429

Rate- oder Monatslimit erreicht

5xx

Vorübergehender Dienstfehler

Client-Verfügbarkeit

TypeScript-Testwerkzeuge und ein Python-Client haben eine implementierte Grundlage. Ein installierbares öffentliches Paket oder ein SDK für alle Sprachen wird noch nicht angeboten.

Abrechnungsstatus

Developer nutzt ein monatliches Stripe-Abo mit monatlichem API-Kontingent. Aufladbares Guthaben wird nicht angeboten. Live-Checkout bleibt bis zu Zahlungs- und Erstattungstests geschlossen.

Zulässige Nutzung

Nutze die API nur für Systeme, die du testen darfst. Spam, Regelumgehung, Kontomissbrauch, Überwachung fremder Kommunikation und langfristige Speicherung personenbezogener Daten sind verboten.

Die API wird produktionsbereit gemacht
Zuerst wird der Vertrag veröffentlicht. Schlüssel und echte Aufrufe öffnen erst nach Prüfung von Webhooks, Kontingenten und Regressionen.
Preise ansehen