Documentation API

Bienvenue dans la documentation de l'API NonMail ! Cette API vous permet de créer et gérer programmatiquement des adresses email temporaires.

Endpoints API

Notre API est conçue pour être simple et facile à utiliser. Tous les endpoints sont accessibles via https://api.nonmail.com/v1/

POST/v1/email/create

Créer une nouvelle adresse email temporaire

Crée une nouvelle adresse email temporaire.

Corps de la Requête :

json

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

Réponse :

json

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

GET/v1/email/inbox

Obtenir les emails pour une adresse

Récupère tous les emails reçus par une adresse email temporaire spécifique.

En-têtes :

bash

Authorization: Bearer your_access_token

Réponse :

json

{{
  "status": "success",
  "emails": [
    {{
      "id": "email_id_1",
      "from": "sender@example.com",
      "subject": "Bonjour de NonMail",
      "body_preview": "Ceci est un aperçu du contenu de l'email...",
      "received_at": 1678885000
    }}
  ]
}}

GET/v1/email/message/email_id_1

Obtenir un email spécifique

Récupère le contenu complet d'un email spécifique.

En-têtes :

bash

Authorization: Bearer your_access_token

Réponse :

json

{{
  "status": "success",
  "id": "email_id_1",
  "from": "sender@example.com",
  "subject": "Bonjour de NonMail",
  "body": "<html><body><p>Le contenu complet de l'email va ici.</p></body></html>",
  "received_at": 1678885000
}}

Authentification

Tous les endpoints authentifiés nécessitent un token API obtenu lors de la création d'un nouvel email. Passez ce token dans l'en-tête Authorization en tant que token Bearer.

bash

Authorization: Bearer your_access_token

Gestion des Erreurs

Notre API utilise des codes de statut HTTP standard pour indiquer le succès ou l'échec d'une requête API.

200 OKLa requête a réussi.

400 Mauvaise RequêteLa requête était malformée ou invalide.

401 Non AutoriséToken API manquant ou invalide.

404 Non TrouvéLa ressource demandée n'a pas pu être trouvée.

500 Erreur Interne du ServeurQuelque chose s'est mal passé de notre côté.

Limitation de Débit

Pour assurer une utilisation équitable, nous implémentons des limites de débit. Actuellement, vous êtes autorisé à 100 requêtes par minute par adresse IP. Dépasser cette limite entraînera une erreur 429 Too Many Requests.

Support Multilingue

La documentation API est disponible en 8 langues. Vous pouvez spécifier la langue souhaitée en définissant l'en-tête Accept-Language dans vos requêtes API, ou en la sélectionnant sur la page de documentation.

Exemple : Accept-Language: ar pour l'arabe.

bash

Accept-Language: ar

Support

Si vous avez des questions ou rencontrez des problèmes, veuillez contacter notre équipe de support à support@nonmail.com.

Exemple d'Utilisation

Voici un exemple complet de comment utiliser l'API avec curl :

bash

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