API-Dokumentation

Willkommen bei der NonMail API-Dokumentation! Diese API ermöglicht es Ihnen, programmatisch temporäre E-Mail-Adressen zu erstellen und zu verwalten.

API-Endpunkte

Unsere API ist darauf ausgelegt, einfach und benutzerfreundlich zu sein. Alle Endpunkte sind über https://api.nonmail.com/v1/

POST/v1/email/create

Neue temporäre E-Mail-Adresse erstellen

Erstellt eine neue temporäre E-Mail-Adresse.

Anfrage-Body:

json

{{
  "duration": 300,
  "prefix": "my-temp-mail"
}}

Antwort:

json

{{
  "status": "success",
  "email": "my-temp-mail_12345@nonmail.com",
  "token": "your_access_token",
  "expires_at": 1678886400
}}

GET/v1/email/inbox

E-Mails für eine Adresse abrufen

Ruft alle E-Mails ab, die von einer bestimmten temporären E-Mail-Adresse empfangen wurden.

Header:

bash

Authorization: Bearer your_access_token

Antwort:

json

{{
  "status": "success",
  "emails": [
    {{
      "id": "email_id_1",
      "from": "sender@example.com",
      "subject": "Hallo von NonMail",
      "body_preview": "Dies ist eine Vorschau des E-Mail-Inhalts...",
      "received_at": 1678885000
    }}
  ]
}}

GET/v1/email/message/email_id_1

Bestimmte E-Mail abrufen

Ruft den vollständigen Inhalt einer bestimmten E-Mail ab.

Header:

bash

Authorization: Bearer your_access_token

Antwort:

json

{{
  "status": "success",
  "id": "email_id_1",
  "from": "sender@example.com",
  "subject": "Hallo von NonMail",
  "body": "<html><body><p>Vollständiger E-Mail-Inhalt hier.</p></body></html>",
  "received_at": 1678885000
}}

Authentifizierung

Alle authentifizierten Endpunkte erfordern ein API-Token, das beim Erstellen einer neuen E-Mail erhalten wird. Übergeben Sie dieses Token im Authorization-Header als Bearer-Token.

bash

Authorization: Bearer your_access_token

Fehlerbehandlung

Unsere API verwendet Standard-HTTP-Statuscodes, um den Erfolg oder Misserfolg einer API-Anfrage anzuzeigen.

200 OKAnfrage war erfolgreich.

400 Ungültige AnfrageDie Anfrage war fehlerhaft oder ungültig.

401 Nicht AutorisierteAPI-Token fehlt oder ist ungültig.

404 Nicht GefundenDie angeforderte Ressource konnte nicht gefunden werden.

500 Interner ServerfehlerEtwas ist auf unserer Seite schief gelaufen.

Rate-Limiting

Um eine faire Nutzung zu gewährleisten, implementieren wir Rate-Limits. Derzeit sind 100 Anfragen pro Minute pro IP-Adresse erlaubt. Das Überschreiten dieses Limits führt zu einem 429 Too Many Requests Fehler.

Sprachunterstützung

Die API-Dokumentation ist in 8 Sprachen verfügbar. Sie können die gewünschte Sprache angeben, indem Sie den Accept-Language-Header in Ihren API-Anfragen setzen oder sie auf der Dokumentationsseite auswählen.

Beispiel: Accept-Language: ar für Arabisch.

bash

Accept-Language: ar

Support

Wenn Sie Fragen haben oder auf Probleme stoßen, wenden Sie sich bitte an unser Support-Team unter support@nonmail.com.

Verwendungsbeispiel

Hier ist ein vollständiges Beispiel, wie Sie die API mit curl verwenden:

bash

curl -X POST https://api.nonmail.com/v1/email/create \
  -H "Content-Type: application/json" \
  -d '{{
    "duration": 300,
    "prefix": "my-temp-mail"
  }}'