Erstellen Sie gegen Run2Mail

Developer API Documentation

Learn how to create API keys, authenticate requests, create inboxes, fetch messages, and handle common Run2Mail API responses.

API-Schlüssel Authentifizierung Kernendpunkte Fehlercodes

API-Schlüssel

Generieren Sie Entwickler-API-Schlüssel über Ihr Dashboard. Jeder Schlüssel wird nur einmal vollständig angezeigt und dann als sicherer Hash zur späteren Überprüfung gespeichert.

Erstellen Sie Schlüssel über Ihr angemeldetes Dashboard.
Halten Sie Schlüssel geheim und bewahren Sie sie in Ihrem eigenen Geheimmanager auf.
Revoke old keys whenever a device, script, or teammate no longer needs access.

Authentifizierung

Verwenden Sie für jede geschützte Anfrage ein Bearer-Token im Authorization-Header.

Authorization: Bearer YOUR_API_KEY

Wenn der Schlüssel ungültig, widerrufen oder fehlt, antwortet die API mit einem Authentifizierungsfehler.

Kernendpunkte

Der gängigste Arbeitsablauf ist: Überprüfen Sie den authentifizierten Benutzer, erstellen Sie einen Posteingang und rufen Sie dann Nachrichten aus diesem Posteingang ab.

Überprüfen Sie das Girokonto

curl -X GET "https://run2mail.com/api/v1/me" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Erstellen Sie einen Posteingang

curl -X POST "https://run2mail.com/api/v1/emails/create" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "random"
  }'

Posteingangsnachrichten abrufen

curl -X GET "https://run2mail.com/api/v1/emails/example@2mail.lol/messages" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Beispiel einer JSON-Antwort

{
  "success": true,
  "data": {
    "email": "example@2mail.lol",
    "messages": []
  }
}

Ratenbegrenzung

Run2Mail wendet planbasierte Anforderungslimits und tägliche Limits für die Erstellung von Posteingängen an, um den Dienst zu schützen und den API-Zugriff stabil zu halten.

Die Tarifbegrenzungen pro Minute hängen von Ihrem aktiven Tarif ab.
Die Grenzwerte für die E-Mail-Erstellung werden getrennt von den grundlegenden Leseaufrufen verfolgt.
Die Nutzung wird zur Sichtbarkeit im Admin-Analyse-Dashboard protokolliert.

Fehlercodes

401: Fehlende oder ungültige API-Anmeldeinformationen.
403: Der Zugriff ist für die Anfrage blockiert, eingeschränkt oder nicht zulässig.
429: Das Anforderungsvolumen hat das aktuelle Limit überschritten.
503: Die Entwickler-API wurde von der Plattform vorübergehend deaktiviert.

Screenshots der Dashboard-API folgen in Kürze

Dieser Bereich ist für zukünftige Screenshots des API-Schlüsselmanagers und des Nutzungs-Dashboards reserviert.