Τεκμηρίωση API

Όταν δεν μεταφέρετε το κλειδί, καλέστε ανώνυμα ως επισκέπτης και η δημιουργία/ανάγνωση προσωρινών γραμματοκιβωτίων είναι εντελώς δωρεάν. Εάν αγοράσετε ένα πακέτο που περιέχει λειτουργίες API, μπορείτε να δημιουργήσετε μόνοι σας ένα κλειδί στο Κέντρο Μελών → Developer API Key Όταν το χρησιμοποιείτε για να το καλέσετε, μπορείτε να απολαύσετε το όριο αποθήκευσης και την περίοδο διατήρησης του αντίστοιχου πακέτου.

Μέθοδος μεταφοράς (επιλέξτε ένα από τα δύο)

Παράδειγμα αιτήματος

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

Δημιουργήστε τυχαία μια προσωρινή διεύθυνση email. Μετά τη δημιουργία της διεύθυνσης, μπορείτε να λάβετε το μήνυμα χωρίς προενεργοποίηση.

Παράμετροι αιτήματος

Παράδειγμα αιτήματος

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

Παράδειγμα απόκρισης

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

Ενεργοποιήστε μια προσαρμοσμένη διεύθυνση προθέματος (πρόθεμα @ domain) για να επαληθεύσετε εάν το όνομα τομέα είναι ανοιχτό για λήψη.

Παράμετροι αιτήματος

Παράδειγμα αιτήματος

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

Παράδειγμα απόκρισης

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

Τραβήξτε τα εισερχόμενα της καθορισμένης διεύθυνσης (τα τελευταία 50 μηνύματα, με αντίστροφη σειρά κατά τον χρόνο παραλαβής). Συνιστάται η διεξαγωγή δημοσκοπήσεων κάθε 1 έως 3 δευτερόλεπτα.

Παράμετροι αιτήματος

Παράδειγμα αιτήματος

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

Παράδειγμα απόκρισης

{
  "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"
    }
  ]
}

Προβολή λεπτομερειών μηνύματος (αποστολέας, θέμα, σώμα, λίστα συνημμένων). Μετά την προβολή, το μήνυμα επισημαίνεται ως αναγνωσμένο.

Παράμετροι αιτήματος

Παράδειγμα αιτήματος

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

Παράδειγμα απόκρισης

{
  "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 }
    ]
  }
}

Κατεβάστε το συνημμένο μηνύματος ηλεκτρονικού ταχυδρομείου (επιστρέφετε απευθείας στη ροή αρχείων

Παράμετροι αιτήματος

Παράδειγμα αιτήματος

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

Αποθηκεύστε μια διεύθυνση στον λογαριασμό σας για μακροπρόθεσμη διατήρηση (απαιτείται σύνδεση ή μεταφορά κλειδιού API), ο αριθμός υπόκειται στο όριο "Αποθηκεύσιμες διευθύνσεις ηλεκτρονικού ταχυδρομείου" του πακέτου.

Παράμετροι αιτήματος

Παράδειγμα αιτήματος

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

Καταχωρίστε τις αποθηκευμένες διευθύνσεις email στον λογαριασμό σας (πρέπει να συνδεθείτε ή να φέρετε το κλειδί API).

Παράδειγμα αιτήματος

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

Το ακόλουθο σενάριο μπορεί να εκτελεστεί απευθείας στην κονσόλα του προγράμματος περιήγησης ή στο περιβάλλον κόμβου: δημιουργία διευθύνσεων, δημοσκόπηση εισερχόμενων και εκτύπωση κωδικών επαλήθευσης κατά τη λήψη του πρώτου μηνύματος ηλεκτρονικού ταχυδρομείου.

// 1. Δημιουργήστε μια προσωρινή διεύθυνση
const BASE = 'https://www.mail0.vip';
const gen = await (await fetch(BASE + '/mail/gen')).json();
const address = gen.address;
console.log('Η προσωρινή μου διεύθυνση email:', address);

// 2. Δημοσκοπήστε τα εισερχόμενα (κάθε 2 δευτερόλεπτα, σταματήστε μόλις λάβετε το πρώτο μήνυμα)
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('Νέο email:', m.subject, code ? 'Κωδικός επαλήθευσης' + code[0] : '');
  }
  await new Promise(r => setTimeout(r, 2000));
}