Documentation API

Lorsque vous ne portez pas la clé avec vous, les appels anonymes sont possibles. La création et la lecture de messageries temporaires sont entièrement gratuites. Si vous avez acheté un package incluant des fonctionnalités API, vous pouvez générer votre propre clé directement dans le centre d’administration de l’utilisateur, sous l’onglet “API pour développeurs”. Lors de l’utilisation de cette clé, vous bénéficierez des limites de stockage et de la durée de conservation prévues par votre package.

Mode de transport (un choix parmi deux)

Exemple de demande

curl "https://www.mail0.vip/mail/gen?key=YOUR_API_KEY"

Une adresse e-mail temporaire est générée aléatoirement. L’adresse est prête à utiliser immédiatement, sans besoin d’activation préalable.

Paramètres demandés

Exemple de demande

curl "https://www.mail0.vip/mail/gen?domain=ideciphera.com&ttl=60"

Exemples de réponses

{
  "code": 1,
  "address": "k3j8fh2ma@ideciphera.com"
}

Activer une adresse avec un préfixe personnalisé (préfixe@nom de domaine). Vérifier si le nom de domaine est ouvert pour recevoir des messages.

Paramètres demandés

Exemple de demande

curl -X POST "https://www.mail0.vip/mail/activate" \
  -d "address=mybox@ideciphera.com&ttl=60"

Exemples de réponses

{
  "code": 1,
  "address": "mybox@ideciphera.com"
}

Récupérer la boîte de réception de l’adresse spécifiée (les 50 dernières messages, affichés dans l’ordre chronologique inverse). Il est conseillé de réaliser une consultation tous les 1 à 3 secondes.

Paramètres demandés

Exemple de demande

curl "https://www.mail0.vip/mail/inbox?address=mybox@ideciphera.com"

Exemples de réponses

{
  "code": 1,
  "exists": 1,
  "address": "mybox@ideciphera.com",
  "list": [
    {
      "id": 1024,
      "from_addr": "noreply@example.com",
      "from_name": "Example",
      "subject": "Your verification code is 826413",
      "size": 2048,
      "is_read": 0,
      "attachments": 0,
      "received_at": "2026-10-14 18:20:31"
    }
  ]
}

Voir les détails de l’e-mail (expéditeur, sujet, contenu, liste des pièces jointes). Après la lecture, l’e-mail est marqué comme lu.

Paramètres demandés

Exemple de demande

curl "https://www.mail0.vip/mail/view?address=mybox@ideciphera.com&id=1024"

Exemples de réponses

{
  "code": 1,
  "data": {
    "id": 1024,
    "from_addr": "noreply@example.com",
    "from_name": "Example",
    "subject": "Your verification code is 826413",
    "body_text": "Dear user, your verification code is 826413, valid for 5 minutes.",
    "received_at_fmt": "2026-10-14 18:20:31",
    "attachments": [
      { "id": 88, "filename": "invoice.pdf", "size": 102400 }
    ]
  }
}

Télécharger le fichier attaché à l’e-mail (données directement sous forme de flux de données, pas en format JSON).

Paramètres demandés

Exemple de demande

curl -O "https://www.mail0.vip/mail/attach?id=88"

Vous pouvez enregistrer une adresse dans votre compte pour qu’elle reste conservée à long terme (il est nécessaire de se connecter ou de disposer d’un clé API). Le nombre de ces adresses enregistrées est limité par la limite indiquée dans le forfait « Nombre d’adresses enregistrables ».

Paramètres demandés

Exemple de demande

curl -X POST "https://www.mail0.vip/mail/save" \
  -d "address=mybox@ideciphera.com&key=YOUR_API_KEY"

Veuillez énumérer les e-mails qui ont été sauvegardés sous votre compte (il est nécessaire de se connecter ou de disposer d'un clé API pour y accéder).

Exemple de demande

curl "https://www.mail0.vip/mail/my?key=YOUR_API_KEY"

Le script suivant peut être exécuté directement dans la console du navigateur ou dans le environnement Node : générer une adresse, effectuer une recherche dans la boîte de réception, et afficher un code de vérification dès que la première mail est reçue.

// 1. Créer un adresse temporaire
const BASE = 'https://www.mail0.vip';
const gen = await (await fetch(BASE + '/mail/gen')).json();
const address = gen.address;
console.log('Mon e-mail temporaire :', address);

// 2. Polling de la boîte de réception (une fois toutes les 2 secondes, s’arrêtant dès que la première message est reçu)
const seen = new Set();
while (true) {
  const d = await (await fetch(BASE + '/mail/inbox?address=' + encodeURIComponent(address))).json();
  for (const m of d.list || []) {
    if (seen.has(m.id)) continue;
    seen.add(m.id);
    const code = (m.subject || '').match(/\d{4,8}/);
    console.log('Nouveaux e-mails :', m.subject, code ? 'Code de vérification ' + code[0] : '');
  }
  await new Promise(r => setTimeout(r, 2000));
}