Τεκμηρίωση API TempMail

REST API v1 & Webhooks

TempMailg Τεκμηρίωση API Προγραμματιστών

Χρησιμοποιήστε αυτήν την τεκμηρίωση για να δημιουργήσετε το προσωπικό σας κλειδί API, να συνδεθείτε με τον αφιερωμένο host API χρήστη, να διαβάσετε μηνύματα ταχυδρομείου, να διαχειριστείτε τα mailbox που ανήκουν σε εσάς και να ενσωματώσετε το Temp Mail στις δικές σας εφαρμογές ή αυτοματοποιήσεις.

Αυθεντικοποίηση με Διακριτικό Webhooks σε πραγματικό χρόνο Gmail & Outlook ψευδώνυμα Απαντήσεις JSON
Βασική Διεύθυνση URL API Χρήστη HTTPS
Μορφή αιτήματος Χρησιμοποιήστε το κλειδί API σας μόνο στο header Αυθεντικοποίησης Bearer και κρατήστε τα URL των endpoint καθαρά.

Διαχείριση γραμματοκιβωτίου

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

GET https://v1.tempmailg.com/api/domains?type={type}
#

Λίστα επιτρεπόμενων τομέων

Λίστα διαθέσιμων τομέων για δημιουργία προσωρινών email. Φιλτράρετε ανά τύπο για να δείτε μόνο δωρεάν, premium ή προσαρμοσμένους τομείς που υποστηρίζονται από το πρόγραμμα συνδρομής σας.

Παράμετροι 1
Παράμετρος Τοποθεσία Τύπος Κατάσταση Περιγραφή
type query string προαιρετικό
Φίλτρο επιπέδου τομέα. Η παράλειψη χρησιμοποιεί όλα όταν η πρόσβαση premium-domain είναι ενεργοποιημένη, διαφορετικά δωρεάν. Αναγνωρισμένες τιμές: free, basic, pro, premium, custom, ultimate, all
Προεπιλογή: Εξαρτάται από λογαριασμό
Λάβετε τις επιτρεπόμενες περιοχές
curl --request GET \
  --url 'https://v1.tempmailg.com/api/domains?type=free' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Εικονογραφική απόκριση χρησιμοποιώντας συνθετικά δεδομένα. Τα IDs, οι διευθύνσεις, τα tokens, οι χρονικές σήμανσεις, τα όρια και οι μετρήσεις του σχεδίου διαφέρουν. Τα δείγματα διάρκειας ζωής δεν παρακάμπτουν την προεπιλογή του σχεδίου σας. Οι περιγραφές των πεδίων της απόκρισης προσδιορίζουν τα nullable και τα provider-specific πεδία.

Παράδειγμα απόκρισης
200 OK • JSON
{
    "status": true,
    "data": {
        "requested_type": "free",
        "plan": "pro",
        "plan_name": "Pro Plan",
        "allowed_types": [
            "free",
            "basic",
            "pro",
            "premium",
            "custom",
            "ultimate",
            "all"
        ],
        "domains": [
            {
                "domain": "example.com",
                "type": "Free",
                "custom": false
            }
        ]
    }
}
Πεδία απόκρισης
Πεδίο Τύπος Περιγραφή
status boolean
Εάν η λειτουργία ολοκληρώθηκε με επιτυχία.
data.requested_type string
Εφαρμόστηκε φίλτρο τομέα.
data.plan string
Τρέχουσα ετικέτα προγράμματος.
data.plan_name string
Αναγνώσιμο όνομα του τρέχοντος σχεδίου.
data.allowed_types array<string>
Φίλτρα τομέα διαθέσιμα σε αυτόν τον λογαριασμό. Ένα αναγνωρισμένο φίλτρο μπορεί ακόμη να απαγορευτεί για το πλάνο σας.
data.domains array
Επιλέξιμα domains μετά το φιλτράρισμα; ένας κενός πίνακας είναι έγκυρος.
data.domains[].domain string
Επιλέξιμο όνομα τομέα.
data.domains[].type string
Ετικέτα επιπέδου αναγνώσιμου τομέα.
data.domains[].custom boolean
Εάν αυτό είναι προσαρμοσμένο domain.
POST https://v1.tempmailg.com/api/emails
#

Δημιουργία προσωρινού γραμματοκιβωτίου

Δημιουργήστε ένα ιδιόκτητο προσωρινό γραμματοκιβώτιο. Παραλείψτε το όνομα χρήστη και τον τομέα για τυχαία δημιουργία, ή παρέχετε ένα επιτρεπόμενο προσαρμοσμένο όνομα χρήστη και έναν επιτρεπόμενο τομέα. Η παράμετρος provider μπορεί να επιλέξει τη δημιουργία ψευδώνυμου Gmail ή Outlook.

Παράμετροι 8
Παράμετρος Τοποθεσία Τύπος Κατάσταση Περιγραφή
username body string προαιρετικό
Προαιρετικό προσαρμοσμένο όνομα χρήστη: 2 έως 64 χαρακτήρες ASCII, γράμματα, ψηφία, τελείες, κάτω παύλες ή παύλες. Απαιτεί άδεια σχεδίου· το custom_username επίσης γίνεται αποδεκτό.
Προεπιλογή: Τυχαία δημιουργημένο
domain body string προαιρετικό
Ένας από τους επιτρεπόμενους τομείς που επιστρέφεται από το GET /domains. Η παράλειψη επιλέγει έναν τυχαίο επιτρεπόμενο τομέα.
Προεπιλογή: Τυχαίο επιτρεπόμενο domain
lifetime body string προαιρετικό
επιτρεπόμενες τιμές:
10m — 10 λεπτά 1h — 1 Ωρα 2h — 2 Ώρες 1d — 1 ημέρα 1w — 1 Εβδομάδα 1m — 30 ημέρες 3m — 90 ημέρες 6m — 180 ημέρες 1y — 365 ημέρες unlimited — Απεριόριστα
Προεπιλογή: Προεπιλεγμένη διάρκεια ζωής του πλάνου
provider body string προαιρετικό
Πάροχος γραμματοκιβωτίου: standard, gmail_alias ή outlook_alias.
Προεπιλογή: standard
pin_enabled body boolean προαιρετικό
Προαιρετική προστασία PIN για το νέο γραμματοκιβώτιο, όταν επιτρέπεται από το πρόγραμμα σας. Δεν αλλάζει το PIN ενός υπάρχοντος γραμματοκιβωτίου.
Προεπιλογή: false
pin body string προαιρετικό
Απαιτείται όταν το pin_enabled είναι true: ένα PIN 6 έως 8 ψηφία, αποστέλλεται ως συμβολοσειρά για να διατηρηθούν τα αρχικά μηδενικά.
pin_confirmation body string προαιρετικό
Απαιτείται όταν το pin_enabled είναι αληθές. Πρέπει να ταιριάζει ακριβώς με το pin.
Idempotency-Key header string προαιρετικό
Απαιτείται για δημιουργία ή διαγραφή με προστασία PIN: ένα σταθερό κλειδί 16 έως 128 χαρακτήρων. Επαναλάβετε το ίδιο αίτημα με το ίδιο κλειδί για να αποφύγετε διπλή εργασία.
Προαιρετικές παραμέτρους σώματος: username (προσαρμοσμένο όνομα χρήστη εάν επιτρέπεται από το πρόγραμμα), domain (επιτρεπόμενος τομέας, π.χ. example.com), lifetime (επιτρεπόμενες τιμές: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited), provider (standard, gmail_alias, outlook_alias). Παραλείψτε τη διάρκεια ζωής ή αφήστε την κενή, ώστε να χρησιμοποιηθεί η Προεπιλεγμένη Διάρκεια Ζωής Ηλεκτρονικού Ταχυδρομείου που έχει ρυθμιστεί για το τρέχον μηνιαίο/ετήσιο πρόγραμμα σας. Στείλτε μια επιτρεπόμενη διάρκεια ζωής, όπως 1h, για να παρακάμψετε αυτήν την προεπιλογή. Το Απεριόριστο χρησιμοποιείται μόνο όταν έχει ρυθμιστεί ως προεπιλογή του προγράμματος ή όταν ζητηθεί ρητά και επιτραπεί. Οι παράμετροι σώματος mailbox_lifetime και email_lifetime επίσης γίνονται αποδεκτές· η πρώτη μη κενή τιμή κερδίζει με τη σειρά: lifetime, mailbox_lifetime, email_lifetime. Οι μη έγκυρες ή μη επιτρεπτές τιμές επιστρέφουν HTTP 422 αντί να επιλέγουν σιωπηρά μια προεπιλογή.
Δημιουργία γραμματοκιβωτίου
curl --request POST \
  --url 'https://v1.tempmailg.com/api/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Εικονογραφική απόκριση χρησιμοποιώντας συνθετικά δεδομένα. Τα IDs, οι διευθύνσεις, τα tokens, οι χρονικές σήμανσεις, τα όρια και οι μετρήσεις του σχεδίου διαφέρουν. Τα δείγματα διάρκειας ζωής δεν παρακάμπτουν την προεπιλογή του σχεδίου σας. Οι περιγραφές των πεδίων της απόκρισης προσδιορίζουν τα nullable και τα provider-specific πεδία.

Παράδειγμα απόκρισης
200 OK • JSON
{
    "status": true,
    "data": {
        "id": 2301,
        "pin_protected": false,
        "email": "demo123@example.com",
        "domain": "example.com",
        "provider": "standard",
        "expire_at": "2026-11-20T02:18:10+00:00",
        "expires_in_seconds": 86399.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:18:10+00:00",
        "email_token": "encrypted-email-token"
    }
}
Πεδία απόκρισης
Πεδίο Τύπος Περιγραφή
status boolean
Εάν η λειτουργία ολοκληρώθηκε με επιτυχία.
data.id integer
ID γραμματοκιβωτίου. Τα παραγόμενα IDs, οι διευθύνσεις και τα tokens διαφέρουν για κάθε γραμματοκιβώτιο.
data.pin_protected boolean
Εάν αυτό το γραμματοκιβώτιο έχει προστασία PIN. Δεν επιστρέχεται κανένα PIN ή hash PIN.
data.email string
Δημιουργήθηκε πλήρης διεύθυνση γραμματοκιβωτίου.
data.domain string
Τομέας του παραγόμενου γραμματοκιβωτίου.
data.provider string
Πάροχος γραμματοκιβωτίου: standard, gmail_alias ή outlook_alias.
data.expire_at string|null
Αποτελεσματική λήξη ως χρονική σήμανση ISO-8601 ή null για απεριόριστο γραμματοκιβώτιο.
data.expires_in_seconds number|null
Μη-αρνητικά δευτερόλεπτα που απομένουν όταν υπολογίζεται· είναι δυνατά κλασματικά δευτερόλεπτα. Το Null σημαίνει απεριόριστο, όχι μηδέν.
data.mailbox_state string
Τρέχουσα κατάσταση γραμματοκιβωτίου: ενεργή, σε παύση, ληγμένη ή ανενεργή.
data.receiving_enabled boolean
Εάν αυτό το γραμματοκιβώτιο δέχεται επί του παρόντος εισερχόμενα μηνύματα.
data.message_count integer
Γνωστή συνολική καταμέτρηση μηνυμάτων· μπορεί να αντικατοπτρίζει την τελευταία συγχρονισμό του γραμματοκιβωτίου.
data.unread_message_count integer
Γνωστός αριθμός μη αναγνωσμένων μηνυμάτων· μπορεί να αντικατοπτρίζει τον τελευταίο συγχρονισμό του γραμματοκιβωτίου.
data.last_message_received_at string|null
Τελευταία γνωστή ώρα λήψης μηνύματος σε μορφή ISO-8601, ή null όταν δεν είναι διαθέσιμη.
data.message_count_synced_at string|null
Τελευταία ώρα συγχρονισμού καταμέτρησης μηνυμάτων σε μορφή ISO-8601, ή null πριν από τον συγχρονισμό.
data.created_at string|null
Χρόνος δημιουργίας γραμματοκιβωτίου σε μορφή ISO-8601.
data.email_token string
Αδιαφανής κρυπτογραφημένη αναφορά γραμματοκιβωτίου. Δεν αντικαθιστά την αυθεντικοποίηση Bearer, τους ελέγχους ιδιοκτησίας ή την εξουσιοδότηση PIN.
data.pin_grant object
Υπό όρους: η δημιουργία ενεργού γραμματοκιβωτίου με προστασία PIN επιστρέφει αυτήν την άδεια ανάγνωσης· η συνηθισμένη δημιουργία χωρίς προστασία την παραλείπει.
data.pin_grant.mailbox_id integer
Αναγνωριστικό γραμματοκιβωτίου στο οποίο δεσμεύεται η υπό όρους άδεια ανάγνωσης.
data.pin_grant.unlock_token string
Αδιαφανές διακριτικό ανάγνωσης για το X-Mailbox-Unlock με τα ίδια διαπιστευτήρια ιδιοκτήτη. Κρατήστε το ιδιωτικό και στη μνήμη· μια άδεια ανάγνωσης δεν εξουσιοδοτεί διαγραφή.
data.pin_grant.scope string
Η ανάγνωση του πεδίου για την υπό όρους χορήγηση δημιουργίας.
data.pin_grant.idle_timeout_seconds integer
Επιτρεπόμενος χρόνος αδράνειας για την άδεια ανάγνωσης, συνήθως 3600 δευτερόλεπτα.
data.pin_grant.absolute_timeout_seconds integer
Μέγιστη διάρκεια ζωής της άδειας ανάγνωσης, συνήθως 86400 δευτερόλεπτα.
data.pin_grant.expires_at string
Τρέχουσα λήξη δικαιώματος ανάγνωσης σε μορφή ISO-8601.
data.pin_grant.absolute_expires_at string
Απόλυτη λήξη άδειας ανάγνωσης σε μορφή ISO-8601. Οι αλλαγές ασφαλείας μπορούν να ανακαλέσουν την άδεια νωρίτερα.
POST https://v1.tempmailg.com/api/emails/{email}/{username}/{domain}
#

Ενημέρωση / Αλλαγή γραμματοκιβωτίου

Δημιουργήστε ή επιλέξτε ένα γραμματοκιβώτιο στο νέο όνομα χρήστη και τομέα μετά την επαλήθευση της ιδιοκτησίας του τρέχοντος γραμματοκιβωτίου. Αυτό δεν μετονομάζει το παλιό γραμματοκιβώτιο ούτε αλλάζει τη διάρκεια ζωής του στη θέση του. Όταν ο προορισμός διαφέρει, το παλιό γραμματοκιβώτιο παραμένει στο ιστορικό και μπορεί να παύσει λειτουργία λόγω περιορισμών ενεργών γραμματοκιβωτίων. Η επαναχρήση του δικού σας ενεργού προορισμού επαναεφαρμόζει τη ζητούμενη διάρκεια ζωής ή την προεπιλογή του σχεδίου.

Παράμετροι 9
Παράμετρος Τοποθεσία Τύπος Κατάσταση Περιγραφή
email path string απαιτείται
Τρέχουσα πλήρης διεύθυνση email του ιδιόκτητου γραμματοκιβωτίου για εναλλαγή. Κωδικοποιήστε με URL κάθε τμήμα διαδρομής· κωδικοποιήστε το σύμβολο συν ως %2B.
username path string απαιτείται
Νέο επιθυμητό όνομα χρήστη: 2 έως 64 αλφαριθμητικούς χαρακτήρες· υπόκειται στην άδεια προσαρμοσμένου ονόματος χρήστη.
domain path string απαιτείται
Νέο επιτρεπόμενο όνομα τομέα.
lifetime body string προαιρετικό
επιτρεπόμενες τιμές:
10m — 10 λεπτά 1h — 1 Ωρα 2h — 2 Ώρες 1d — 1 ημέρα 1w — 1 Εβδομάδα 1m — 30 ημέρες 3m — 90 ημέρες 6m — 180 ημέρες 1y — 365 ημέρες unlimited — Απεριόριστα
Προεπιλογή: Προεπιλεγμένη διάρκεια ζωής του πλάνου
pin_enabled body boolean προαιρετικό
Προαιρετική προστασία PIN για το νέο γραμματοκιβώτιο, όταν επιτρέπεται από το πρόγραμμα σας. Δεν αλλάζει το PIN ενός υπάρχοντος γραμματοκιβωτίου.
Προεπιλογή: false
pin body string προαιρετικό
Απαιτείται όταν το pin_enabled είναι true: ένα PIN 6 έως 8 ψηφία, αποστέλλεται ως συμβολοσειρά για να διατηρηθούν τα αρχικά μηδενικά.
pin_confirmation body string προαιρετικό
Απαιτείται όταν το pin_enabled είναι αληθές. Πρέπει να ταιριάζει ακριβώς με το pin.
Idempotency-Key header string προαιρετικό
Απαιτείται για δημιουργία ή διαγραφή με προστασία PIN: ένα σταθερό κλειδί 16 έως 128 χαρακτήρων. Επαναλάβετε το ίδιο αίτημα με το ίδιο κλειδί για να αποφύγετε διπλή εργασία.
X-Mailbox-Unlock header string προαιρετικό
Κεφαλίδα, μόνο προστατευμένα γραμματοκιβώτια: χρησιμοποιήστε ένα read unlock_token. Πρώτα κάντε POST pin και scope=read στη διεύθυνση URL ξεκλειδώματος PIN. Διατηρήστε την κανονική σας πιστοποίηση Bearer. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Χρησιμοποιήστε ένα υπάρχον mailbox email στο {email}. Προαιρετική παράμετρος σώματος: lifetime (επιτρεπόμενες τιμές: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Παραλείψτε τη διάρκεια ζωής ή αφήστε την κενή, ώστε να χρησιμοποιηθεί η Προεπιλεγμένη Διάρκεια Ζωής Ηλεκτρονικού Ταχυδρομείου που έχει ρυθμιστεί για το τρέχον μηνιαίο/ετήσιο πρόγραμμα σας. Στείλτε μια επιτρεπόμενη διάρκεια ζωής, όπως 1h, για να παρακάμψετε αυτήν την προεπιλογή. Το Απεριόριστο χρησιμοποιείται μόνο όταν έχει ρυθμιστεί ως προεπιλογή του προγράμματος ή όταν ζητηθεί ρητά και επιτραπεί. Οι παράμετροι σώματος mailbox_lifetime και email_lifetime επίσης γίνονται αποδεκτές· η πρώτη μη κενή τιμή κερδίζει με τη σειρά: lifetime, mailbox_lifetime, email_lifetime. Οι μη έγκυρες ή μη επιτρεπτές τιμές επιστρέφουν HTTP 422 αντί να επιλέγουν σιωπηρά μια προεπιλογή.
Ενημερώστε το mailbox που ανήκει στον χρήστη
curl --request POST \
  --url 'https://v1.tempmailg.com/api/emails/current@example.com/demo123/example.com' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Εικονογραφική απόκριση χρησιμοποιώντας συνθετικά δεδομένα. Τα IDs, οι διευθύνσεις, τα tokens, οι χρονικές σήμανσεις, τα όρια και οι μετρήσεις του σχεδίου διαφέρουν. Τα δείγματα διάρκειας ζωής δεν παρακάμπτουν την προεπιλογή του σχεδίου σας. Οι περιγραφές των πεδίων της απόκρισης προσδιορίζουν τα nullable και τα provider-specific πεδία.

Παράδειγμα απόκρισης
200 OK • JSON
{
    "status": true,
    "data": {
        "id": 2302,
        "pin_protected": false,
        "email": "demo123@example.com",
        "domain": "example.com",
        "provider": "standard",
        "expire_at": "2026-11-19T02:28:10+00:00",
        "expires_in_seconds": 599.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:18:10+00:00",
        "email_token": "encrypted-email-token"
    }
}
Πεδία απόκρισης
Πεδίο Τύπος Περιγραφή
status boolean
Εάν η λειτουργία ολοκληρώθηκε με επιτυχία.
data.id integer
ID γραμματοκιβωτίου. Τα παραγόμενα IDs, οι διευθύνσεις και τα tokens διαφέρουν για κάθε γραμματοκιβώτιο.
data.pin_protected boolean
Εάν αυτό το γραμματοκιβώτιο έχει προστασία PIN. Δεν επιστρέχεται κανένα PIN ή hash PIN.
data.email string
Δημιουργήθηκε πλήρης διεύθυνση γραμματοκιβωτίου.
data.domain string
Τομέας του παραγόμενου γραμματοκιβωτίου.
data.provider string
Πάροχος γραμματοκιβωτίου: standard, gmail_alias ή outlook_alias.
data.expire_at string|null
Αποτελεσματική λήξη ως χρονική σήμανση ISO-8601 ή null για απεριόριστο γραμματοκιβώτιο.
data.expires_in_seconds number|null
Μη-αρνητικά δευτερόλεπτα που απομένουν όταν υπολογίζεται· είναι δυνατά κλασματικά δευτερόλεπτα. Το Null σημαίνει απεριόριστο, όχι μηδέν.
data.mailbox_state string
Τρέχουσα κατάσταση γραμματοκιβωτίου: ενεργή, σε παύση, ληγμένη ή ανενεργή.
data.receiving_enabled boolean
Εάν αυτό το γραμματοκιβώτιο δέχεται επί του παρόντος εισερχόμενα μηνύματα.
data.message_count integer
Γνωστή συνολική καταμέτρηση μηνυμάτων· μπορεί να αντικατοπτρίζει την τελευταία συγχρονισμό του γραμματοκιβωτίου.
data.unread_message_count integer
Γνωστός αριθμός μη αναγνωσμένων μηνυμάτων· μπορεί να αντικατοπτρίζει τον τελευταίο συγχρονισμό του γραμματοκιβωτίου.
data.last_message_received_at string|null
Τελευταία γνωστή ώρα λήψης μηνύματος σε μορφή ISO-8601, ή null όταν δεν είναι διαθέσιμη.
data.message_count_synced_at string|null
Τελευταία ώρα συγχρονισμού καταμέτρησης μηνυμάτων σε μορφή ISO-8601, ή null πριν από τον συγχρονισμό.
data.created_at string|null
Χρόνος δημιουργίας γραμματοκιβωτίου σε μορφή ISO-8601.
data.email_token string
Αδιαφανής κρυπτογραφημένη αναφορά γραμματοκιβωτίου. Δεν αντικαθιστά την αυθεντικοποίηση Bearer, τους ελέγχους ιδιοκτησίας ή την εξουσιοδότηση PIN.
data.pin_grant object
Υπό όρους: η δημιουργία ενεργού γραμματοκιβωτίου με προστασία PIN επιστρέφει αυτήν την άδεια ανάγνωσης· η συνηθισμένη δημιουργία χωρίς προστασία την παραλείπει.
data.pin_grant.mailbox_id integer
Αναγνωριστικό γραμματοκιβωτίου στο οποίο δεσμεύεται η υπό όρους άδεια ανάγνωσης.
data.pin_grant.unlock_token string
Αδιαφανές διακριτικό ανάγνωσης για το X-Mailbox-Unlock με τα ίδια διαπιστευτήρια ιδιοκτήτη. Κρατήστε το ιδιωτικό και στη μνήμη· μια άδεια ανάγνωσης δεν εξουσιοδοτεί διαγραφή.
data.pin_grant.scope string
Η ανάγνωση του πεδίου για την υπό όρους χορήγηση δημιουργίας.
data.pin_grant.idle_timeout_seconds integer
Επιτρεπόμενος χρόνος αδράνειας για την άδεια ανάγνωσης, συνήθως 3600 δευτερόλεπτα.
data.pin_grant.absolute_timeout_seconds integer
Μέγιστη διάρκεια ζωής της άδειας ανάγνωσης, συνήθως 86400 δευτερόλεπτα.
data.pin_grant.expires_at string
Τρέχουσα λήξη δικαιώματος ανάγνωσης σε μορφή ISO-8601.
data.pin_grant.absolute_expires_at string
Απόλυτη λήξη άδειας ανάγνωσης σε μορφή ISO-8601. Οι αλλαγές ασφαλείας μπορούν να ανακαλέσουν την άδεια νωρίτερα.
DELETE https://v1.tempmailg.com/api/emails/{email}
#

Διαγραφή γραμματοκιβωτίου

Διαγράψτε ένα ιδιόκτητο γραμματοκιβώτιο και ενεργοποιήστε τον καθαρισμό των μηνυμάτων και των αρχείων του. Τα διατηρημένα αρχεία γραμματοκιβωτίου ενδέχεται να διαγραφούν εσωτερικά με ήπιο τρόπο· η διεύθυνση δεν είναι πλέον διαθέσιμη μέσω του API.

Παράμετροι 3
Παράμετρος Τοποθεσία Τύπος Κατάσταση Περιγραφή
email path string απαιτείται
Πλήρης διεύθυνση email του ιδιόκτητου γραμματοκιβωτίου προς διαγραφή. Κωδικοποιήστε τη διεύθυνση σε URL· κωδικοποιήστε το σύμβολο συν (+) ως %2B.
X-Mailbox-Unlock header string προαιρετικό
Κεφαλίδα, μόνο για προστατευμένα γραμματοκιβώτια: χρησιμοποιήστε το one-use delete unlock_token. Πρώτο POST pin, scope=delete και το action/target_id που επιστρέφεται από την απάντηση 423 στη διεύθυνση URL ξεκλειδώματος PIN. Ένα token ανάγνωσης δεν μπορεί να διαγράψει. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Idempotency-Key header string προαιρετικό
Απαιτείται για δημιουργία ή διαγραφή με προστασία PIN: ένα σταθερό κλειδί 16 έως 128 χαρακτήρων. Επαναλάβετε το ίδιο αίτημα με το ίδιο κλειδί για να αποφύγετε διπλή εργασία.
Διαγράψτε το mailbox που ανήκει στον χρήστη
curl --request DELETE \
  --url 'https://v1.tempmailg.com/api/emails/demo123@example.com' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Εικονογραφική απόκριση χρησιμοποιώντας συνθετικά δεδομένα. Τα IDs, οι διευθύνσεις, τα tokens, οι χρονικές σήμανσεις, τα όρια και οι μετρήσεις του σχεδίου διαφέρουν. Τα δείγματα διάρκειας ζωής δεν παρακάμπτουν την προεπιλογή του σχεδίου σας. Οι περιγραφές των πεδίων της απόκρισης προσδιορίζουν τα nullable και τα provider-specific πεδία.

Παράδειγμα απόκρισης
200 OK • JSON
{
    "status": true,
    "message": "Email has been successfully deleted."
}
Πεδία απόκρισης
Πεδίο Τύπος Περιγραφή
status boolean
Εάν η λειτουργία ολοκληρώθηκε με επιτυχία.
message string
Αποτέλεσμα της διαγραφής. Ένας ελλείπων πόρος επιστρέφει HTTP 404.

Gmail & Outlook ψευδώνυμα

Δημιουργήστε γραμματοκιβώτια ψευδώνυμων υψηλής φήμης Gmail και Outlook/Hotmail.

POST https://v1.tempmailg.com/api/gmail-alias/emails
#

Δημιουργία ψευδώνυμου Gmail

Δημιουργήστε ένα νέο προσωρινό γραμματοκιβώτιο ψευδώνυμου Gmail που ανήκει στον πιστοποιημένο χρήστη.

Παράμετροι 8
Παράμετρος Τοποθεσία Τύπος Κατάσταση Περιγραφή
mode body string προαιρετικό
Λειτουργία δημιουργίας: auto, dot, plus ή plus_dot. Δέχεται επίσης gmail_alias_mode. Εάν δεν επιτρέπεται η επιλογή στυλ, χρησιμοποιείται το auto.
Προεπιλογή: auto
username body string προαιρετικό
Προαιρετικό προσαρμοσμένο επίθημα ψευδωνύμου: 2 έως 32 χαρακτήρες ASCII (γράμματα ή ψηφία), κανονικοποιημένα σε πεζά; υπόκειται σε άδεια λειτουργίας. Δέχεται επίσης custom_username ή alias_username.
Προεπιλογή: Αυτόματη δημιουργία
domain body string προαιρετικό
Χρησιμοποιήστε τυχαίο, gmail.com ή googlemail.com; alias_domain επίσης γίνεται αποδεκτό. Η παράλειψη ή η μη διαθέσιμη άδεια επιλογής τομέα χρησιμοποιεί τυχαίο.
Προεπιλογή: random
lifetime body string προαιρετικό
επιτρεπόμενες τιμές:
10m — 10 λεπτά 1h — 1 Ωρα 2h — 2 Ώρες 1d — 1 ημέρα 1w — 1 Εβδομάδα 1m — 30 ημέρες 3m — 90 ημέρες 6m — 180 ημέρες 1y — 365 ημέρες unlimited — Απεριόριστα
Προεπιλογή: Προεπιλεγμένη διάρκεια ζωής του πλάνου
pin_enabled body boolean προαιρετικό
Προαιρετική προστασία PIN για το νέο γραμματοκιβώτιο, όταν επιτρέπεται από το πρόγραμμα σας. Δεν αλλάζει το PIN ενός υπάρχοντος γραμματοκιβωτίου.
Προεπιλογή: false
pin body string προαιρετικό
Απαιτείται όταν το pin_enabled είναι true: ένα PIN 6 έως 8 ψηφία, αποστέλλεται ως συμβολοσειρά για να διατηρηθούν τα αρχικά μηδενικά.
pin_confirmation body string προαιρετικό
Απαιτείται όταν το pin_enabled είναι αληθές. Πρέπει να ταιριάζει ακριβώς με το pin.
Idempotency-Key header string προαιρετικό
Απαιτείται για δημιουργία ή διαγραφή με προστασία PIN: ένα σταθερό κλειδί 16 έως 128 χαρακτήρων. Επαναλάβετε το ίδιο αίτημα με το ίδιο κλειδί για να αποφύγετε διπλή εργασία.
Απαιτεί την άδεια Gmail Alias API να είναι ενεργοποιημένη στο πρόγραμμα συνδρομής σας ή να ξεκλειδωθεί μέσω πακέτου Πίστωση API. Προαιρετικές παράμετροι: mode (auto, dot, plus, plus_dot), username (προσαρμοσμένο ψευδώνυμο χρήστη), domain (π.χ. gmail.com, googlemail.com), lifetime (επιτρεπόμενες τιμές: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Παραλείψτε τη διάρκεια ζωής ή αφήστε την κενή, ώστε να χρησιμοποιηθεί η Προεπιλεγμένη Διάρκεια Ζωής Ηλεκτρονικού Ταχυδρομείου που έχει ρυθμιστεί για το τρέχον μηνιαίο/ετήσιο πρόγραμμα σας. Στείλτε μια επιτρεπόμενη διάρκεια ζωής, όπως 1h, για να παρακάμψετε αυτήν την προεπιλογή. Το Απεριόριστο χρησιμοποιείται μόνο όταν έχει ρυθμιστεί ως προεπιλογή του προγράμματος ή όταν ζητηθεί ρητά και επιτραπεί. Οι παράμετροι σώματος mailbox_lifetime και email_lifetime επίσης γίνονται αποδεκτές· η πρώτη μη κενή τιμή κερδίζει με τη σειρά: lifetime, mailbox_lifetime, email_lifetime. Οι μη έγκυρες ή μη επιτρεπτές τιμές επιστρέφουν HTTP 422 αντί να επιλέγουν σιωπηρά μια προεπιλογή.
Δημιουργία ψευδώνυμου γραμματοκιβωτίου Gmail
curl --request POST \
  --url 'https://v1.tempmailg.com/api/gmail-alias/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Εικονογραφική απόκριση χρησιμοποιώντας συνθετικά δεδομένα. Τα IDs, οι διευθύνσεις, τα tokens, οι χρονικές σήμανσεις, τα όρια και οι μετρήσεις του σχεδίου διαφέρουν. Τα δείγματα διάρκειας ζωής δεν παρακάμπτουν την προεπιλογή του σχεδίου σας. Οι περιγραφές των πεδίων της απόκρισης προσδιορίζουν τα nullable και τα provider-specific πεδία.

Παράδειγμα απόκρισης
200 OK • JSON
{
    "status": true,
    "data": {
        "id": 2305,
        "pin_protected": false,
        "email": "example+alias123@gmail.com",
        "domain": "gmail.com",
        "provider": "gmail_alias",
        "expire_at": "2026-11-19T03:18:10+00:00",
        "expires_in_seconds": 3599.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:18:10+00:00",
        "email_token": "encrypted-email-token"
    }
}
Πεδία απόκρισης
Πεδίο Τύπος Περιγραφή
status boolean
Εάν η λειτουργία ολοκληρώθηκε με επιτυχία.
data.id integer
ID γραμματοκιβωτίου. Τα παραγόμενα IDs, οι διευθύνσεις και τα tokens διαφέρουν για κάθε γραμματοκιβώτιο.
data.pin_protected boolean
Εάν αυτό το γραμματοκιβώτιο έχει προστασία PIN. Δεν επιστρέχεται κανένα PIN ή hash PIN.
data.email string
Δημιουργήθηκε πλήρης διεύθυνση γραμματοκιβωτίου.
data.domain string
Τομέας του παραγόμενου γραμματοκιβωτίου.
data.provider string
Πάροχος γραμματοκιβωτίου: standard, gmail_alias ή outlook_alias.
data.expire_at string|null
Αποτελεσματική λήξη ως χρονική σήμανση ISO-8601 ή null για απεριόριστο γραμματοκιβώτιο.
data.expires_in_seconds number|null
Μη-αρνητικά δευτερόλεπτα που απομένουν όταν υπολογίζεται· είναι δυνατά κλασματικά δευτερόλεπτα. Το Null σημαίνει απεριόριστο, όχι μηδέν.
data.mailbox_state string
Τρέχουσα κατάσταση γραμματοκιβωτίου: ενεργή, σε παύση, ληγμένη ή ανενεργή.
data.receiving_enabled boolean
Εάν αυτό το γραμματοκιβώτιο δέχεται επί του παρόντος εισερχόμενα μηνύματα.
data.message_count integer
Γνωστή συνολική καταμέτρηση μηνυμάτων· μπορεί να αντικατοπτρίζει την τελευταία συγχρονισμό του γραμματοκιβωτίου.
data.unread_message_count integer
Γνωστός αριθμός μη αναγνωσμένων μηνυμάτων· μπορεί να αντικατοπτρίζει τον τελευταίο συγχρονισμό του γραμματοκιβωτίου.
data.last_message_received_at string|null
Τελευταία γνωστή ώρα λήψης μηνύματος σε μορφή ISO-8601, ή null όταν δεν είναι διαθέσιμη.
data.message_count_synced_at string|null
Τελευταία ώρα συγχρονισμού καταμέτρησης μηνυμάτων σε μορφή ISO-8601, ή null πριν από τον συγχρονισμό.
data.created_at string|null
Χρόνος δημιουργίας γραμματοκιβωτίου σε μορφή ISO-8601.
data.email_token string
Αδιαφανής κρυπτογραφημένη αναφορά γραμματοκιβωτίου. Δεν αντικαθιστά την αυθεντικοποίηση Bearer, τους ελέγχους ιδιοκτησίας ή την εξουσιοδότηση PIN.
data.pin_grant object
Υπό όρους: η δημιουργία ενεργού γραμματοκιβωτίου με προστασία PIN επιστρέφει αυτήν την άδεια ανάγνωσης· η συνηθισμένη δημιουργία χωρίς προστασία την παραλείπει.
data.pin_grant.mailbox_id integer
Αναγνωριστικό γραμματοκιβωτίου στο οποίο δεσμεύεται η υπό όρους άδεια ανάγνωσης.
data.pin_grant.unlock_token string
Αδιαφανές διακριτικό ανάγνωσης για το X-Mailbox-Unlock με τα ίδια διαπιστευτήρια ιδιοκτήτη. Κρατήστε το ιδιωτικό και στη μνήμη· μια άδεια ανάγνωσης δεν εξουσιοδοτεί διαγραφή.
data.pin_grant.scope string
Η ανάγνωση του πεδίου για την υπό όρους χορήγηση δημιουργίας.
data.pin_grant.idle_timeout_seconds integer
Επιτρεπόμενος χρόνος αδράνειας για την άδεια ανάγνωσης, συνήθως 3600 δευτερόλεπτα.
data.pin_grant.absolute_timeout_seconds integer
Μέγιστη διάρκεια ζωής της άδειας ανάγνωσης, συνήθως 86400 δευτερόλεπτα.
data.pin_grant.expires_at string
Τρέχουσα λήξη δικαιώματος ανάγνωσης σε μορφή ISO-8601.
data.pin_grant.absolute_expires_at string
Απόλυτη λήξη άδειας ανάγνωσης σε μορφή ISO-8601. Οι αλλαγές ασφαλείας μπορούν να ανακαλέσουν την άδεια νωρίτερα.
GET https://v1.tempmailg.com/api/outlook-alias/domains
#

Τομείς ψευδώνυμου Outlook

Ανάκτηση ενεργών τομέων ψευδώνυμων Outlook / Hotmail που είναι διαθέσιμοι για δημιουργία γραμματοκιβωτίου.

Απαιτεί την ενεργοποίηση της άδειας Outlook Alias API στο πρόγραμμα συνδρομής σας ή την απελευθέρωση μέσω πακέτου Πίστωση API. Δείχνει εάν η επιλογή συγκεκριμένου τομέα είναι ξεκλείδωτη στο πρόγραμμα σας.
Λήψη τομέων ψευδώνυμου Outlook
curl --request GET \
  --url 'https://v1.tempmailg.com/api/outlook-alias/domains' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Εικονογραφική απόκριση χρησιμοποιώντας συνθετικά δεδομένα. Τα IDs, οι διευθύνσεις, τα tokens, οι χρονικές σήμανσεις, τα όρια και οι μετρήσεις του σχεδίου διαφέρουν. Τα δείγματα διάρκειας ζωής δεν παρακάμπτουν την προεπιλογή του σχεδίου σας. Οι περιγραφές των πεδίων της απόκρισης προσδιορίζουν τα nullable και τα provider-specific πεδία.

Παράδειγμα απόκρισης
200 OK • JSON
{
    "status": true,
    "data": {
        "domains": [
            {
                "domain": "outlook.com",
                "type": "Outlook/Hotmail",
                "selectable": true,
                "locked": false,
                "disabled_reason": null
            },
            {
                "domain": "hotmail.com",
                "type": "Outlook/Hotmail",
                "selectable": true,
                "locked": false,
                "disabled_reason": null
            }
        ]
    }
}
Πεδία απόκρισης
Πεδίο Τύπος Περιγραφή
status boolean
Εάν η λειτουργία ολοκληρώθηκε με επιτυχία.
data.domains array
Ενεργά Outlook/Hotmail domains; ένας κενός πίνακας είναι έγκυρος.
data.domains[].domain string
Διαθέσιμο όνομα τομέα.
data.domains[].type string
Αναγνώσιμη ετικέτα παρόχου.
data.domains[].selectable boolean
Εάν ο λογαριασμός σας μπορεί ρητά να επιλέξει αυτόν τον τομέα.
data.domains[].locked boolean
Εάν η ρητή επιλογή domain είναι κλειδωμένη για τον λογαριασμό σας.
data.domains[].disabled_reason string|null
Ο λόγος που η επιλογή τομέα είναι κλειδωμένη, ή null όταν είναι επιλέξιμη.
POST https://v1.tempmailg.com/api/outlook-alias/emails
#

Δημιουργία ψευδώνυμου Outlook

Δημιουργήστε ένα νέο προσωρινό γραμματοκιβώτιο ψευδώνυμου Outlook / Hotmail που ανήκει στον πιστοποιημένο χρήστη.

Παράμετροι 7
Παράμετρος Τοποθεσία Τύπος Κατάσταση Περιγραφή
domain body string προαιρετικό
Χρησιμοποιήστε τυχαίο ή ένα domain από το GET /outlook-alias/domains; το outlook_alias_domain επίσης γίνεται αποδεκτό. Χωρίς άδεια επιλογής, χρησιμοποιείται τυχαίο.
Προεπιλογή: Τυχαίο διαθέσιμο domain
username body string προαιρετικό
Προαιρετικό προσαρμοσμένο επίθημα ψευδωνύμου: 2 έως 32 χαρακτήρες ASCII (γράμματα ή ψηφία), κανονικοποιημένα σε πεζά; υπόκειται σε άδεια λειτουργίας. Δέχεται επίσης custom_username ή alias_username.
Προεπιλογή: Αυτόματη δημιουργία
lifetime body string προαιρετικό
επιτρεπόμενες τιμές:
10m — 10 λεπτά 1h — 1 Ωρα 2h — 2 Ώρες 1d — 1 ημέρα 1w — 1 Εβδομάδα 1m — 30 ημέρες 3m — 90 ημέρες 6m — 180 ημέρες 1y — 365 ημέρες unlimited — Απεριόριστα
Προεπιλογή: Προεπιλεγμένη διάρκεια ζωής του πλάνου
pin_enabled body boolean προαιρετικό
Προαιρετική προστασία PIN για το νέο γραμματοκιβώτιο, όταν επιτρέπεται από το πρόγραμμα σας. Δεν αλλάζει το PIN ενός υπάρχοντος γραμματοκιβωτίου.
Προεπιλογή: false
pin body string προαιρετικό
Απαιτείται όταν το pin_enabled είναι true: ένα PIN 6 έως 8 ψηφία, αποστέλλεται ως συμβολοσειρά για να διατηρηθούν τα αρχικά μηδενικά.
pin_confirmation body string προαιρετικό
Απαιτείται όταν το pin_enabled είναι αληθές. Πρέπει να ταιριάζει ακριβώς με το pin.
Idempotency-Key header string προαιρετικό
Απαιτείται για δημιουργία ή διαγραφή με προστασία PIN: ένα σταθερό κλειδί 16 έως 128 χαρακτήρων. Επαναλάβετε το ίδιο αίτημα με το ίδιο κλειδί για να αποφύγετε διπλή εργασία.
Απαιτεί την ενεργοποίηση της άδειας Outlook Alias API στο πρόγραμμα συνδρομής σας ή την απελευθέρωση μέσω πακέτου Πίστωση API. Προαιρετικές παράμετροι: domain (π.χ. outlook.com, hotmail.com), username (προσαρμοσμένο ψευδώνυμο χρήστη), lifetime (επιτρεπόμενες τιμές: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Παραλείψτε τη διάρκεια ζωής ή αφήστε την κενή, ώστε να χρησιμοποιηθεί η Προεπιλεγμένη Διάρκεια Ζωής Ηλεκτρονικού Ταχυδρομείου που έχει ρυθμιστεί για το τρέχον μηνιαίο/ετήσιο πρόγραμμα σας. Στείλτε μια επιτρεπόμενη διάρκεια ζωής, όπως 1h, για να παρακάμψετε αυτήν την προεπιλογή. Το Απεριόριστο χρησιμοποιείται μόνο όταν έχει ρυθμιστεί ως προεπιλογή του προγράμματος ή όταν ζητηθεί ρητά και επιτραπεί. Οι παράμετροι σώματος mailbox_lifetime και email_lifetime επίσης γίνονται αποδεκτές· η πρώτη μη κενή τιμή κερδίζει με τη σειρά: lifetime, mailbox_lifetime, email_lifetime. Οι μη έγκυρες ή μη επιτρεπτές τιμές επιστρέφουν HTTP 422 αντί να επιλέγουν σιωπηρά μια προεπιλογή.
Δημιουργία ψευδώνυμου γραμματοκιβωτίου Outlook
curl --request POST \
  --url 'https://v1.tempmailg.com/api/outlook-alias/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Εικονογραφική απόκριση χρησιμοποιώντας συνθετικά δεδομένα. Τα IDs, οι διευθύνσεις, τα tokens, οι χρονικές σήμανσεις, τα όρια και οι μετρήσεις του σχεδίου διαφέρουν. Τα δείγματα διάρκειας ζωής δεν παρακάμπτουν την προεπιλογή του σχεδίου σας. Οι περιγραφές των πεδίων της απόκρισης προσδιορίζουν τα nullable και τα provider-specific πεδία.

Παράδειγμα απόκρισης
200 OK • JSON
{
    "status": true,
    "data": {
        "id": 2306,
        "pin_protected": false,
        "email": "example+alias45@outlook.com",
        "domain": "outlook.com",
        "provider": "outlook_alias",
        "expire_at": "2026-11-19T03:18:10+00:00",
        "expires_in_seconds": 3599.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:18:10+00:00",
        "email_token": "encrypted-email-token"
    }
}
Πεδία απόκρισης
Πεδίο Τύπος Περιγραφή
status boolean
Εάν η λειτουργία ολοκληρώθηκε με επιτυχία.
data.id integer
ID γραμματοκιβωτίου. Τα παραγόμενα IDs, οι διευθύνσεις και τα tokens διαφέρουν για κάθε γραμματοκιβώτιο.
data.pin_protected boolean
Εάν αυτό το γραμματοκιβώτιο έχει προστασία PIN. Δεν επιστρέχεται κανένα PIN ή hash PIN.
data.email string
Δημιουργήθηκε πλήρης διεύθυνση γραμματοκιβωτίου.
data.domain string
Τομέας του παραγόμενου γραμματοκιβωτίου.
data.provider string
Πάροχος γραμματοκιβωτίου: standard, gmail_alias ή outlook_alias.
data.expire_at string|null
Αποτελεσματική λήξη ως χρονική σήμανση ISO-8601 ή null για απεριόριστο γραμματοκιβώτιο.
data.expires_in_seconds number|null
Μη-αρνητικά δευτερόλεπτα που απομένουν όταν υπολογίζεται· είναι δυνατά κλασματικά δευτερόλεπτα. Το Null σημαίνει απεριόριστο, όχι μηδέν.
data.mailbox_state string
Τρέχουσα κατάσταση γραμματοκιβωτίου: ενεργή, σε παύση, ληγμένη ή ανενεργή.
data.receiving_enabled boolean
Εάν αυτό το γραμματοκιβώτιο δέχεται επί του παρόντος εισερχόμενα μηνύματα.
data.message_count integer
Γνωστή συνολική καταμέτρηση μηνυμάτων· μπορεί να αντικατοπτρίζει την τελευταία συγχρονισμό του γραμματοκιβωτίου.
data.unread_message_count integer
Γνωστός αριθμός μη αναγνωσμένων μηνυμάτων· μπορεί να αντικατοπτρίζει τον τελευταίο συγχρονισμό του γραμματοκιβωτίου.
data.last_message_received_at string|null
Τελευταία γνωστή ώρα λήψης μηνύματος σε μορφή ISO-8601, ή null όταν δεν είναι διαθέσιμη.
data.message_count_synced_at string|null
Τελευταία ώρα συγχρονισμού καταμέτρησης μηνυμάτων σε μορφή ISO-8601, ή null πριν από τον συγχρονισμό.
data.created_at string|null
Χρόνος δημιουργίας γραμματοκιβωτίου σε μορφή ISO-8601.
data.email_token string
Αδιαφανής κρυπτογραφημένη αναφορά γραμματοκιβωτίου. Δεν αντικαθιστά την αυθεντικοποίηση Bearer, τους ελέγχους ιδιοκτησίας ή την εξουσιοδότηση PIN.
data.pin_grant object
Υπό όρους: η δημιουργία ενεργού γραμματοκιβωτίου με προστασία PIN επιστρέφει αυτήν την άδεια ανάγνωσης· η συνηθισμένη δημιουργία χωρίς προστασία την παραλείπει.
data.pin_grant.mailbox_id integer
Αναγνωριστικό γραμματοκιβωτίου στο οποίο δεσμεύεται η υπό όρους άδεια ανάγνωσης.
data.pin_grant.unlock_token string
Αδιαφανές διακριτικό ανάγνωσης για το X-Mailbox-Unlock με τα ίδια διαπιστευτήρια ιδιοκτήτη. Κρατήστε το ιδιωτικό και στη μνήμη· μια άδεια ανάγνωσης δεν εξουσιοδοτεί διαγραφή.
data.pin_grant.scope string
Η ανάγνωση του πεδίου για την υπό όρους χορήγηση δημιουργίας.
data.pin_grant.idle_timeout_seconds integer
Επιτρεπόμενος χρόνος αδράνειας για την άδεια ανάγνωσης, συνήθως 3600 δευτερόλεπτα.
data.pin_grant.absolute_timeout_seconds integer
Μέγιστη διάρκεια ζωής της άδειας ανάγνωσης, συνήθως 86400 δευτερόλεπτα.
data.pin_grant.expires_at string
Τρέχουσα λήξη δικαιώματος ανάγνωσης σε μορφή ISO-8601.
data.pin_grant.absolute_expires_at string
Απόλυτη λήξη άδειας ανάγνωσης σε μορφή ISO-8601. Οι αλλαγές ασφαλείας μπορούν να ανακαλέσουν την άδεια νωρίτερα.

Μηνύματα & Συνημμένα

Ανάκτηση εισερχόμενων γραμματοκιβωτίων, ανάγνωση πλήρων μηνυμάτων HTML/κειμένου και ροή συνημμένων.

GET https://v1.tempmailg.com/api/messages?email={email}
#

Λίστα μηνυμάτων γραμματοκιβωτίου

Ανακτήστε τα διαθέσιμα σύνοψη μηνυμάτων και τα μεταδεδομένα του γραμματοκιβωτίου. Οι τυπικές σαρώσεις εισερχομένων επιστρέφουν μια πρόσφατη παρτίδα έως 25 μηνύματα· αυτό δεν είναι ένα σελιδοποιημένο endpoint πλήρους ιστορικού. Χρησιμοποιήστε GET /messages/{messageId} για πλήρη σώματα και συνημμένα.

Παράμετροι 2
Παράμετρος Τοποθεσία Τύπος Κατάσταση Περιγραφή
email query string απαιτείται
Πλήρης διεύθυνση email του ιδιόκτητου γραμματοκιβωτίου από το οποίο θα διαβάζονται τα μηνύματα. Κωδικοποιήστε την τιμή ερωτήματος σε URL· κωδικοποιήστε το σύμβολο συν ως %2B.
X-Mailbox-Unlock header string προαιρετικό
Κεφαλίδα, μόνο προστατευμένα γραμματοκιβώτια: χρησιμοποιήστε ένα read unlock_token. Πρώτα κάντε POST pin και scope=read στη διεύθυνση URL ξεκλειδώματος PIN. Διατηρήστε την κανονική σας πιστοποίηση Bearer. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Το email πρέπει να ανήκει στον λογαριασμό σας. Τα πρότυπα και τα σύνολα Gmail περιέχουν πεδία OTP και verification-link· Outlook επίσης περιλαμβάνει from_name, snippet, received_at και has_attachments. Ο συγχρονισμός του παρόχου και η προσωρινή αποθήκευση μπορεί να καθυστερήσουν τα νέα μηνύματα και τις μετρήσεις.
Διαβάστε τα μηνύματα του mailbox
curl --request GET \
  --url 'https://v1.tempmailg.com/api/messages?email=demo123@example.com' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Εικονογραφική απόκριση χρησιμοποιώντας συνθετικά δεδομένα. Τα IDs, οι διευθύνσεις, τα tokens, οι χρονικές σήμανσεις, τα όρια και οι μετρήσεις του σχεδίου διαφέρουν. Τα δείγματα διάρκειας ζωής δεν παρακάμπτουν την προεπιλογή του σχεδίου σας. Οι περιγραφές των πεδίων της απόκρισης προσδιορίζουν τα nullable και τα provider-specific πεδία.

Παράδειγμα απόκρισης
200 OK • JSON
{
    "status": true,
    "mailbox": "demo123@example.com",
    "email_token": "encrypted-email-token",
    "messages": [
        {
            "is_seen": false,
            "subject": "Welcome to Temp Mail",
            "from": "Example Sender",
            "from_email": "hello@example.org",
            "receivedAt": "2026-11-19 02:18:10",
            "id": "ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1",
            "otp": null,
            "otp_locked": false,
            "verification_link": null,
            "verification_link_locked": false
        }
    ],
    "mailbox_provider": "standard",
    "mailbox_state": "active",
    "expire_at": "2026-11-20T02:18:10+00:00",
    "expires_in_seconds": 86399.75,
    "receiving_enabled": true,
    "mailbox_limit": {
        "limit": 50,
        "limit_label": "50",
        "active_count": 1,
        "paused_count": 0,
        "paused_mailboxes": [],
        "remaining": 49,
        "remaining_label": "49",
        "reached": false,
        "blocked": false,
        "provider": "standard"
    },
    "message_count": 1,
    "unread_message_count": 1,
    "last_message_received_at": "2026-11-19T02:18:10+00:00",
    "message_count_synced_at": "2026-11-19T02:18:10+00:00"
}
Πεδία απόκρισης
Πεδίο Τύπος Περιγραφή
status boolean
Εάν η λειτουργία ολοκληρώθηκε με επιτυχία.
mailbox string
Διεύθυνση γραμματοκιβωτίου των μηνυμάτων που ζητήθηκαν.
email_token string
Αδιαφανής κρυπτογραφημένη αναφορά γραμματοκιβωτίου· απαιτείται κανονική πιστοποίηση.
mailbox_provider string
Πάροχος γραμματοκιβωτίου: standard, gmail_alias ή outlook_alias.
messages array
Περίληψη μηνυμάτων. Ένα κενό εισερχόμενο επιστρέφει έναν κενό πίνακα· ανακτήστε ένα μόνο μήνυμα για το σώμα και τα συνημμένα του.
expire_at string|null
Αποτελεσματική λήξη ως χρονική σήμανση ISO-8601 ή null για απεριόριστο γραμματοκιβώτιο.
expires_in_seconds number|null
Μη-αρνητικά δευτερόλεπτα που απομένουν όταν υπολογίζεται· είναι δυνατά κλασματικά δευτερόλεπτα. Το Null σημαίνει απεριόριστο, όχι μηδέν.
mailbox_state string
Τρέχουσα κατάσταση γραμματοκιβωτίου: ενεργή, σε παύση, ληγμένη ή ανενεργή.
receiving_enabled boolean
Εάν αυτό το γραμματοκιβώτιο δέχεται επί του παρόντος εισερχόμενα μηνύματα.
message_count integer
Γνωστή συνολική καταμέτρηση μηνυμάτων· μπορεί να αντικατοπτρίζει την τελευταία συγχρονισμό του γραμματοκιβωτίου.
unread_message_count integer
Γνωστός αριθμός μη αναγνωσμένων μηνυμάτων· μπορεί να αντικατοπτρίζει τον τελευταίο συγχρονισμό του γραμματοκιβωτίου.
last_message_received_at string|null
Τελευταία γνωστή ώρα λήψης μηνύματος σε μορφή ISO-8601, ή null όταν δεν είναι διαθέσιμη.
message_count_synced_at string|null
Τελευταία ώρα συγχρονισμού καταμέτρησης μηνυμάτων σε μορφή ISO-8601, ή null πριν από τον συγχρονισμό.
mailbox_limit.limit integer
Όριο ενεργών γραμματοκιβωτίων για αυτόν τον πάροχο; -1 σημαίνει απεριόριστο.
mailbox_limit.limit_label string
Ετικέτα εμφάνισης για το όριο γραμματοκιβωτίου.
mailbox_limit.active_count integer
Αριθμός ενεργών γραμματοκιβωτίων για αυτόν τον πάροχο.
mailbox_limit.paused_count integer
Αριθμός ανασταλμένων γραμματοκιβωτίων για αυτόν τον πάροχο.
mailbox_limit.paused_mailboxes array<string>
Διευθύνσεις σε παύση λόγω του ορίου γραμματοκιβωτίου.
mailbox_limit.remaining integer
Απομένουν ενεργές θέσεις γραμματοκιβωτίου· -1 σημαίνει απεριόριστο. Αυτό δεν είναι όριο αιτήσεων API.
mailbox_limit.remaining_label string
Εμφάνιση ετικέτας για τα υπόλοιπα κενά γραμματοκιβωτίου.
mailbox_limit.reached boolean
Εάν το ενεργό όριο γραμματοκιβωτίου έχει φτάσει.
mailbox_limit.blocked boolean
Εάν το ενεργό όριο γραμματοκιβωτίου είναι μηδέν.
mailbox_limit.provider string|null
Πάροχος στον οποίο εφαρμόζεται το όριο γραμματοκιβωτίου.
messages[].id string
Αδιαφανές αναγνωριστικό μηνύματος που χρησιμοποιείται από τα τελικά σημεία ενός μηνύματος, διαγραφής και συνημμένου.
messages[].is_seen boolean
Εάν το μήνυμα είναι σημειωμένο ως αναγνωσμένο.
messages[].subject string
Θέμα μηνύματος.
messages[].from string
Εμφανιζόμενο όνομα ή διεύθυνση αποστολέα.
messages[].from_email string
Διεύθυνση email αποστολέα.
messages[].receivedAt string
Ώρα λήψης στη ζώνη ώρας της εφαρμογής, μορφοποιημένη ως YYYY-MM-DD HH:mm:ss.
messages[].otp string|null
Εντοπίστηκε κωδικός μίας χρήσης όταν είναι διαθέσιμος και επιτρέπεται· διαφορετικά null.
messages[].otp_locked boolean
Εάν ένας εντοπισμένος κωδικός μίας χρήσης κρύβεται από τα δικαιώματα λειτουργίας.
messages[].verification_link string|null
Εντοπίστηκε URL επαλήθευσης όταν είναι διαθέσιμο και επιτρέπεται· διαφορετικά null.
messages[].verification_link_locked boolean
Εάν ένας εντοπισμένος σύνδεσμος επαλήθευσης είναι κρυμμένος από τα δικαιώματα λειτουργίας.
messages[].from_name string|null
Πεδίο σύνοψης Outlook: όνομα αρχικού αποστολέα. Απουσία από τις περιλήψεις Standard και Gmail.
messages[].snippet string|null
Πεδίο σύνοψης Outlook: σύντομη προεπισκόπηση μηνύματος.
messages[].received_at string|null
Πεδίο σύνοψης Outlook: ώρα λήψης ISO-8601, όταν είναι γνωστή.
messages[].has_attachments boolean
Πεδίο σύνοψης Outlook: εάν υπάρχουν μεταδεδομένα συνημμένων. Η διαθεσιμότητα λήψης ελέγχεται ξεχωριστά.
GET https://v1.tempmailg.com/api/messages/{messageId}
#

Λήψη Μονού Μηνύματος

Ανακτήστε ένα ιδιόκτητο μήνυμα με το αδιαφανές ID του μηνύματος. Επιστρέφει μορφές σώματος και μεταδεδομένα συνημμένων. Τα πεδία του σώματος εξαρτώνται από τη μορφή του μηνύματος· το Outlook προσθέτει πεδία ειδικά για τον πάροχο που αναφέρονται παρακάτω.

Παράμετροι 2
Παράμετρος Τοποθεσία Τύπος Κατάσταση Περιγραφή
messageId path string απαιτείται
Μοναδικό αναγνωριστικό μηνύματος που επιστρέφεται στη λίστα μηνυμάτων.
X-Mailbox-Unlock header string προαιρετικό
Κεφαλίδα, μόνο προστατευμένα γραμματοκιβώτια: χρησιμοποιήστε ένα read unlock_token. Πρώτα κάντε POST pin και scope=read στη διεύθυνση URL ξεκλειδώματος PIN. Διατηρήστε την κανονική σας πιστοποίηση Bearer. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Διαβάστε ένα μήνυμα
curl --request GET \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Εικονογραφική απόκριση χρησιμοποιώντας συνθετικά δεδομένα. Τα IDs, οι διευθύνσεις, τα tokens, οι χρονικές σήμανσεις, τα όρια και οι μετρήσεις του σχεδίου διαφέρουν. Τα δείγματα διάρκειας ζωής δεν παρακάμπτουν την προεπιλογή του σχεδίου σας. Οι περιγραφές των πεδίων της απόκρισης προσδιορίζουν τα nullable και τα provider-specific πεδία.

Παράδειγμα απόκρισης
200 OK • JSON
{
    "status": true,
    "data": {
        "is_seen": true,
        "subject": "Welcome to Temp Mail",
        "from": "Example Sender",
        "from_email": "hello@example.org",
        "to": "demo123@example.com",
        "mailbox_provider": "standard",
        "receivedAt": "2026-11-19 02:18:10",
        "id": "ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1",
        "html": true,
        "html_content": "<p>Hello from the inbox.</p>",
        "text_content": "<pre>Hello from the inbox.</pre>",
        "content": "<p>Hello from the inbox.</p>",
        "attachments": [
            {
                "name": "file.txt",
                "extension": "txt",
                "size": 91,
                "url": "https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt"
            }
        ]
    }
}
Πεδία απόκρισης
Πεδίο Τύπος Περιγραφή
status boolean
Εάν η λειτουργία ολοκληρώθηκε με επιτυχία.
data.id string
Αδιαφανές αναγνωριστικό μηνύματος.
data.is_seen boolean
Κατάσταση ανάγνωσης μηνύματος. Η ανάγνωση μπορεί να το σημάνει ως αναγνωσμένο; τα αποθηκευμένα δεδομένα μπορεί να αντικατοπτρίζουν προηγούμενη κατάσταση.
data.subject string
Θέμα μηνύματος.
data.from string
Εμφανιζόμενο όνομα ή διεύθυνση αποστολέα.
data.from_email string
Διεύθυνση email αποστολέα.
data.to string
Διεύθυνση γραμματοκιβωτίου παραλήπτη.
data.mailbox_provider string
Πάροχος γραμματοκιβωτίου: standard, gmail_alias ή outlook_alias.
data.receivedAt string
Ώρα λήψης στη ζώνη ώρας της εφαρμογής, μορφοποιημένη ως YYYY-MM-DD HH:mm:ss.
data.html boolean
Καθορίζει αν το μήνυμα έχει σώμα HTML.
data.html_content string
Σώμα HTML όταν υπάρχει. Τα τυπικά μηνύματα χωρίς HTML μπορούν να παραλείψουν αυτό το πεδίο. Θεωρήστε το περιεχόμενο του μηνύματος ως μη αξιόπιστο.
data.text_content string
Κείμενο σώματος όταν υπάρχει; Τα τυπικά μηνύματα μπορεί να περιέχουν διαφραγμένο κείμενο σε στοιχείο pre ή να παραλείψουν αυτό το πεδίο.
data.content string
Προτιμώμενο σώμα για εμφάνιση, συνήθως HTML όταν είναι διαθέσιμο.
data.attachments array
Μεταδεδομένα συνημμένου, ή ένας κενός πίνακας. Οι λήψεις απαιτούν κανονική πιστοποίηση και την κατάλληλη εξουσιοδότηση PIN.
data.attachments[].name string
Όνομα αρχείου για κωδικοποίηση URL ως ένα ενιαίο τμήμα διαδρομής κατά τη λήψη.
data.attachments[].size integer
Μέγεθος συνημμένου σε bytes.
data.attachments[].url string
Προστέθηκε URL λήψης API για πιστοποιημένο χρήστη στα συνημμένα με όνομα αρχείου. Ένα URL δεν εγγυάται ότι το τοπικό αρχείο είναι διαθέσιμο.
data.attachments[].extension string
Πεδίο μεταδεδομένων Standard/Gmail: επέκταση αρχείου όταν παρέχεται.
data.attachments[].id string
Πεδίο μεταδεδομένων Outlook: αναγνωριστικό συνημμένου παρόχου.
data.attachments[].content_type string
Πεδίο μεταδεδομένων Outlook: τύπος περιεχομένου MIME.
data.from_name string|null
Πεδίο λεπτομέρειας Outlook: όνομα αρχικού αποστολέα.
data.to_email string|null
Πεδίο λεπτομέρειας Outlook: αρχική διεύθυνση παραλήπτη.
data.received_at string|null
Πεδίο λεπτομέρειας Outlook: ώρα λήψης ISO-8601.
data.has_html boolean
Πεδίο λεπτομέρειας Outlook: εάν υπάρχει σώμα HTML.
DELETE https://v1.tempmailg.com/api/messages/{messageId}
#

Διαγραφή μηνύματος

Διαγράψτε ένα μόνο μήνυμα που ανήκει στον χρήστη.

Παράμετροι 3
Παράμετρος Τοποθεσία Τύπος Κατάσταση Περιγραφή
messageId path string απαιτείται
Μοναδική συμβολοσειρά αναγνωριστικού μηνύματος για μόνιμη διαγραφή.
X-Mailbox-Unlock header string προαιρετικό
Κεφαλίδα, μόνο για προστατευμένα γραμματοκιβώτια: χρησιμοποιήστε το one-use delete unlock_token. Πρώτο POST pin, scope=delete και το action/target_id που επιστρέφεται από την απάντηση 423 στη διεύθυνση URL ξεκλειδώματος PIN. Ένα token ανάγνωσης δεν μπορεί να διαγράψει. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Idempotency-Key header string προαιρετικό
Απαιτείται για δημιουργία ή διαγραφή με προστασία PIN: ένα σταθερό κλειδί 16 έως 128 χαρακτήρων. Επαναλάβετε το ίδιο αίτημα με το ίδιο κλειδί για να αποφύγετε διπλή εργασία.
Διαγράψτε ένα μήνυμα
curl --request DELETE \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Εικονογραφική απόκριση χρησιμοποιώντας συνθετικά δεδομένα. Τα IDs, οι διευθύνσεις, τα tokens, οι χρονικές σήμανσεις, τα όρια και οι μετρήσεις του σχεδίου διαφέρουν. Τα δείγματα διάρκειας ζωής δεν παρακάμπτουν την προεπιλογή του σχεδίου σας. Οι περιγραφές των πεδίων της απόκρισης προσδιορίζουν τα nullable και τα provider-specific πεδία.

Παράδειγμα απόκρισης
200 OK • JSON
{
    "status": true,
    "message": "Message was deleted successfully."
}
Πεδία απόκρισης
Πεδίο Τύπος Περιγραφή
status boolean
Εάν η λειτουργία ολοκληρώθηκε με επιτυχία.
message string
Αποτέλεσμα της διαγραφής. Ένας ελλείπων πόρος επιστρέφει HTTP 404.
GET https://v1.tempmailg.com/api/messages/{messageId}/attachments/{filename}
#

Λήψη συνημμένου

Κατεβάστε μια συνημμένη αρχείο από ένα μήνυμα που ανήκει σε εσάς.

Παράμετροι 3
Παράμετρος Τοποθεσία Τύπος Κατάσταση Περιγραφή
messageId path string απαιτείται
Αναγνωριστικό του μηνύματος που περιέχει το αρχείο.
filename path string απαιτείται
Όνομα αρχείου και επέκταση του συνημμένου για λήψη.
X-Mailbox-Unlock header string προαιρετικό
Κεφαλίδα, μόνο προστατευμένα γραμματοκιβώτια: χρησιμοποιήστε ένα read unlock_token. Πρώτα κάντε POST pin και scope=read στη διεύθυνση URL ξεκλειδώματος PIN. Διατηρήστε την κανονική σας πιστοποίηση Bearer. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Η επιτυχία επιστρέφει τα bytes του αρχείου, όχι JSON. Τα υπερμεγέθη αρχεία επιστρέφουν HTTP 403; τα ελλιπή ή μη διαθέσιμα τοπικά αρχεία επιστρέφουν HTTP 404. Κωδικοποιήστε το όνομα αρχείου σε URL ως ένα ενιαίο τμήμα διαδρομής. Τα μεταδεδομένα του συνημμένου από μόνα τους δεν εγγυώνται τη διαθεσιμότητα λήψης.
Κατεβάστε μια συνημμένη αρχείο
curl --request GET \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY' \
  --output file.txt
Συμπεριφορά λήψης Αυτό το τερματικό επιστρέφει το αιτούμενο αρχείο απευθείας αντί για σώμα JSON.
Πεδία απόκρισης
Πεδίο Τύπος Περιγραφή
Content-Disposition header
Η επιτυχής απόκριση κατεβάζει το ζητούμενο όνομα αρχείου.
body binary
Τα bytes του αρχείου σε επιτυχία, όχι JSON. Τα σφάλματα επιστρέφουν JSON με κατάσταση μη-2xx.

Όρια Ρυθμού & Ποσοστώσεις

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

GET https://v1.tempmailg.com/api/rate-limit
#

Όριο Ρυθμού & Ποσό

Ελέγξτε το τρέχον όριο ταχύτητας και την κατάσταση του quota χωρίς να καταναλώνετε καμία χρήση API. Αυτό το σημείο τελικού είναι χωρίς quota και δεν αφαιρεί μηνιαίες πιστώσεις API (όριο προστασίας κατά κακής χρήσης: 60 αιτήματα/λεπτό).

Το X-RateLimit-* περιγράφει τον υποδεικνυόμενο προϋπολογισμό αιτήσεων· το X-Quota-* περιγράφει τη μηνιαία και αγορασμένη χωρητικότητα όταν είναι διαθέσιμη. Το X-Mailbox-RateLimit-* αναφέρει τον ξεχωριστό προϋπολογισμό δημιουργίας/ενημέρωσης γραμματοκιβωτίου. Μια απόρριψη μόνο για γραμματοκιβώτιο χρησιμοποιεί το πεδίο γραμματοκιβωτίου και το δικό του παράθυρο επανάληψης. Οι απορρίψεις περιορισμού ανά λεπτό μπορεί να παραλείπουν πληροφορίες ποσόστωσης. Το Retry-After περιλαμβάνεται μόνο για χρονική επανάληψη· η απενεργοποιημένη πρόσβαση μπορεί να απαιτεί αλλαγή λογαριασμού. Σε αυτήν την επιτυχημένη απόκριση κατάστασης, τα data.limit, data.remaining και data.reset περιγράφουν τον προϋπολογισμό λεπτών του λογαριασμού, όχι τα διαθέσιμα πιστώματα. Το αντικείμενο data.quota περιγράφει το μηνιαίο όριο, τα υπόλοιπα πιστώματα και τη χρήση. Τα υπάρχοντα πεδία data.monthly_limit, data.monthly_remaining και data.purchased_credits παραμένουν ψευδώνυμα των αντίστοιχων πεδίων quota. Μια επιτυχής έλεγχος κατάστασης δεν εξουσιοδοτεί άλλη λειτουργία API. Οι λειτουργίες εξακολουθούν να απαιτούν ενεργοποιημένη πρόσβαση, διαθέσιμο ποσό και έγκριση μέσω όλων των εφαρμοστέων ορίων. Η λήψη στιγμιότυπου ποσού δεν εγγυάται χωρητικότητα που έχει ήδη δεσμευτεί από ένα εν εξελίξει αίτημα.
Έλεγχος κατάστασης ορίου ταχύτητας
curl --request GET \
  --url 'https://v1.tempmailg.com/api/rate-limit' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Εικονογραφική απόκριση χρησιμοποιώντας συνθετικά δεδομένα. Τα IDs, οι διευθύνσεις, τα tokens, οι χρονικές σήμανσεις, τα όρια και οι μετρήσεις του σχεδίου διαφέρουν. Τα δείγματα διάρκειας ζωής δεν παρακάμπτουν την προεπιλογή του σχεδίου σας. Οι περιγραφές των πεδίων της απόκρισης προσδιορίζουν τα nullable και τα provider-specific πεδία.

Παράδειγμα απόκρισης
200 OK • JSON
{
    "status": "success",
    "data": {
        "limit": 60,
        "remaining": 45,
        "reset": 32,
        "plan": "premium",
        "monthly_limit": 50000,
        "monthly_remaining": 48210,
        "purchased_credits": 5000,
        "quota": {
            "enabled": true,
            "user_api_status": true,
            "plan_name": "Premium Plan",
            "period": "2026-10",
            "base_limit": 50000,
            "extra_requests": 0,
            "monthly_limit": 50000,
            "monthly_remaining": 48210,
            "used": 1790,
            "purchased_credits": 5000,
            "bonus_credits": 1000,
            "direct_purchased_credits": 4000,
            "remaining": 53210,
            "unlimited": false,
            "usage_percent": 3,
            "reset_at": "2026-11-01T00:00:00+00:00"
        }
    }
}
Πεδία απόκρισης
Πεδίο Τύπος Περιγραφή
data.limit integer|string
Όριο αιτήσεων ανά λεπτό λογαριασμού. Η συμβολοσειρά unlimited υποδεικνύει απεριόριστο προϋπολογισμό ανά λεπτό· αυτό είναι ανεξάρτητο από το μηνιαίο όριο.
data.remaining integer|string
Απομένουν θέσεις προϋπολογισμού λεπτών λογαριασμού, ή η συμβολοσειρά unlimited. Μια θετική τιμή δεν σημαίνει ότι απομένουν πιστώσεις API.
data.reset integer
Δευτερόλεπτα για το παράθυρο λεπτών του λογαριασμού, όχι για την επαναφορά του μηνιαίου ορίου. Τα απενεργοποιημένα ή απεριόριστα προϋπολογιστικά λεπτά μπορούν να διατηρήσουν μια ονομαστική τιμή 60 δευτερολέπτων; αυτό δεν εγγυάται πρόσβαση μετά την αναμονή.
data.plan string
Τρέχουσα ετικέτα προγράμματος. Το αναγνώσιμο όνομα προγράμματος παρέχεται ξεχωριστά στο data.quota.plan_name.
data.quota.enabled boolean
Εάν η πρόσβαση API παγκόσμια και ανά πρόγραμμα/πίστωση είναι ενεργοποιημένη. Αυτό δεν υποδεικνύει την υπόλοιπη χωρητικότητα ή αντικαθιστά το διακόπτη API του χρήστη.
data.quota.user_api_status boolean
Εάν ο χρήστης έχει ενεργοποιήσει το διακόπτη User API. Οι λειτουργίες απαιτούν αυτόν τον διακόπτη καθώς και ενεργή πρόσβαση και διαθέσιμη χωρητικότητα.
data.quota.plan_name string
Αναγνώσιμο όνομα του τρέχοντος σχεδίου.
data.quota.period string
Διάστημα χρήσης σε μορφή ημερολογιακού μήνα YYYY-MM, χρησιμοποιώντας τη ζώνη ώρας της εφαρμογής· δεν είναι απαραίτητα η περίοδος χρέωσης της συνδρομής.
data.quota.base_limit integer
Βασική μηνιαία χορήγηση του πλάνου. Μια τιμή -1 σημαίνει απεριόριστο.
data.quota.extra_requests integer
Παραχωρήθηκε επιπλέον μηνιαία επιδότηση για την τρέχουσα περίοδο χρήσης; ξεχωριστά από τα αγορασμένα credits.
data.quota.monthly_limit integer
Βασική χορήγηση συν επιπλέον αιτήματα τρέχουσας περιόδου. Μια τιμή -1 σημαίνει απεριόριστο. Οι αγορασμένοι πόντοι δεν περιλαμβάνονται.
data.quota.monthly_remaining integer|null
Υπόλοιπο πεπερασμένου μηνιαίου επιδόματος, ή null όταν το μηνιαίο όριο είναι απεριόριστο. Το null δεν πρέπει να ερμηνευθεί ως μηδέν.
data.quota.used integer
Επιτυχείς, καταμετρημένες λειτουργίες API στην τρέχουσα περίοδο χρήσης, συμπεριλαμβανομένων των λειτουργιών που χρησιμοποιούν πιστώσεις. Οι έλεγχοι κατάστασης δεν αυξάνουν αυτή την τιμή.
data.quota.purchased_credits integer
Τρέχον υπόλοιπο πίστωσης, συμπεριλαμβανομένων των μονάδων πίστωσης μπόνους του ενεργού σχεδίου. Οι μονάδες πίστωσης μπόνους δεν πρέπει να προστεθούν σε αυτό το υπόλοιπο δεύτερη φορά.
data.quota.bonus_credits integer
Ενεργό τμήμα μπόνους του σχεδίου του υπολοίπου πίστωσης· ανάλυση των purchased_credits, όχι επιπλέον χωρητικότητα.
data.quota.direct_purchased_credits integer
Υπόλοιπο πίστωσης χωρίς το ενεργό τμήμα μπόνους του σχεδίου. Αυτή η τιμή συν το bonus_credits ισούται με το purchased_credits.
data.quota.remaining integer|null
Μηνιαίο υπόλοιπο άδειασης συν το τρέχον υπόλοιπο πίστωσης, χωρίς διπλή καταμέτρηση των μπόνους. Null σημαίνει απεριόριστο μηνιαίο όριο. Τα ατομικά δικαιώματα λειτουργιών και άλλα όρια αιτήσεων εξακολουθούν να ισχύουν.
data.quota.unlimited boolean
Εάν το μηνιαίο όριο είναι απεριόριστο. Αυτό δεν κάνει το προϋπολογισμό λεπτών του λογαριασμού ή άλλα όρια λειτουργιών απεριόριστα.
data.quota.usage_percent integer
Στρογγυλοποιημένο ποσοστό συμβατό με τον πίνακα ελέγχου από 0 έως 100: χρησιμοποιημένο διαιρεμένο με το χρησιμοποιημένο συν το υπόλοιπο, πολλαπλασιασμένο με 100. Περιλαμβάνει τη διαθέσιμη χωρητικότητα πίστωσης, έτσι η επαναφόρτιση μπορεί να μειώσει το ποσοστό. Είναι 0 για απεριόριστο όριο ή δεξαμενή μηδενικού μεγέθους· δεν είναι το ποσοστό περιορισμού ανά λεπτό ή μια απόφαση πρόσβασης.
data.quota.reset_at string
Χρονική σήμανση ISO-8601 με μετατόπιση ζώνης ώρας για την επόμενη επαναφορά ορίου του ημερολογιακού μήνα. Αυτό δεν είναι η ημερομηνία λήξης της συνδρομής, και η μηνιαία επαναφορά δεν επαναγεμίζει τα αγορασμένα credits.
status string
Η κυριολεκτική επιτυχία για αυτό το σημείο κατάστασης. Άλλα επιτυχημένα σημεία τελικού γραμματοκιβωτίου χρησιμοποιούν τη λογική τιμή true.
data.monthly_limit integer
Συμβατό ψευδώνυμο του αντίστοιχου πεδίου data.quota· μην το προσθέσετε ξανά κατά τον υπολογισμό των υπολοίπων.
data.monthly_remaining integer|null
Συμβατό ψευδώνυμο του αντίστοιχου πεδίου data.quota· μην το προσθέσετε ξανά κατά τον υπολογισμό των υπολοίπων.
data.purchased_credits integer
Συμβατό ψευδώνυμο του αντίστοιχου πεδίου data.quota· μην το προσθέσετε ξανά κατά τον υπολογισμό των υπολοίπων.

Προστασία PIN Ταχυδρομικού Γραμματοκιβωτίου

Εισάγετε το PIN για να συνεχίσετε. Το γραμματοκιβώτιό σας παραμένει ξεκλείδωτο όσο είναι ενεργό σε αυτή τη συνεδρία του ιστότοπου.

Αποδέχεστε τα cookies;

Χρησιμοποιούμε cookies για να βελτιώσουμε την εμπειρία πλοήγησής σας. Με τη χρήση αυτού του ιστότοπου, συναινείτε στην πολιτική μας σχετικά με τα cookies.

Περισσότερα