Λίστα ελέγχου γρήγορης εγκατάστασης
- Ανοίξτε τη σελίδα διαχείρισης API του πίνακα ελέγχου σας και δημιουργήστε το προσωπικό σας κλειδί API.
- Αντιγράψτε την ακριβή διεύθυνση URL Βάσης API Χρήστη που εμφανίζεται εκεί, για παράδειγμα https://v1.tempmailg.com/api.
- Στείλτε κάθε αίτημα σε αυτόν τον host API με Authorization: Bearer YOUR_USER_API_KEY και Accept: application/json.
- Παρακολουθήστε το μηνιαίο όριο αιτήσεων από την ίδια σελίδα πίνακα ελέγχου και από τις κεφαλίδες ορίου όταν είναι διαθέσιμες στις απαντήσεις του API χρήστη. Μόνο οι επιτυχείς αιτήσεις 2xx μετράνε προς το όριο.
Πρόσβαση API κλειδιού
Συνδεθείτε για να δημιουργήσετε το προσωπικό σας κλειδί API και να προβάλετε ζωντανούς λεπτομέρειες ποσόστωσης.
Ροή αυθεντικοποίησης
- Γεννήστε το προσωπικό σας κλειδί API από τη σελίδα διαχείρισης API του πίνακα ελέγχου.
- Αποστείλετε το κλειδί ως token Bearer σε κάθε αίτηση.
- Χρησιμοποιήστε τον αφιερωμένο χρήστη API Base URL που εμφανίζεται στη σελίδα διαχείρισης API σας.
- Αναγεννήστε το κλειδί οποιαδήποτε στιγμή που θέλετε να ακυρώσετε το παλιό και να αρχίσετε να χρησιμοποιείτε ένα νέο κλειδί αμέσως.
Απαιτούμενες κεφαλίδες
Authorization: Bearer YOUR_USER_API_KEY
Accept: application/json
Κεφαλίδες Ορίου Ταχύτητας & Ποσοστού
Οι κεφαλίδες περιορισμού ταχύτητας περιγράφουν τον υποδεικνυόμενο προϋπολογισμό αιτήσεων. Οι κεφαλίδες ποσόστωσης περιλαμβάνονται όταν είναι διαθέσιμες πληροφορίες ποσόστωσης· οι απορρίψεις περιορισμού λεπτών δεν υπολογίζουν το πλήρες μηνιαίο σας ποσό.
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1729520000
X-Quota-Limit: 50000
X-Quota-Remaining: 48210
X-Quota-Used: 1790
X-Quota-Reset: 2026-11-01T00:00:00+00:00
X-RateLimit-Scope: account
Retry-After: 42 (when a timed retry is available)
X-RateLimit-Limit— Μέγιστος αριθμός αιτήσεων που επιτρέπεται ανά λεπτό (RPM) για το πρόγραμμα σας.X-RateLimit-Remaining— Απομένουν αιτήματα RPM στο τρέχον παράθυρο λεπτών.X-RateLimit-Reset— Χρονική σήμανση Unix όταν επαναφέρεται το τρέχον παράθυρο περιορισμού ρυθμού ανά λεπτό.X-Quota-Limit— Συνολική μηνιαία και αγορασμένη χωρητικότητα πίστωσης για τον λογαριασμό σας.X-Quota-Remaining— Απομένουν διαθέσιμα αιτήματα API στον τρέχοντα μήνα.X-Quota-Used— Συνολικές αιτήσεις API που καταναλώθηκαν κατά τη διάρκεια της τρέχουσας περιόδου χρέωσης.X-Quota-Reset— Χρονική σήμανση ISO-8601 όταν επαναφέρεται το μηνιαίο σας όριο.X-RateLimit-Scope— Ο προϋπολογισμός που περιγράφεται από τις κεφαλίδες: account, ip, status_endpoint ή mailbox.X-Mailbox-RateLimit-*— Ξεχωριστός προϋπολογισμός δημιουργίας/ενημέρωσης γραμματοκιβωτίου. Οι επιτυχείς απαντήσεις γραμματοκιβωτίου διατηρούν το RPM λογαριασμού στο X-RateLimit-*; μια απόρριψη μόνο γραμματοκιβωτίου χρησιμοποιεί το πεδίο εφαρμογής του γραμματοκιβωτίου και το δικό της παράθυρο επανάληψης.Retry-After— Δευτερόλεπτα μέχρι να είναι κατάλληλη μια χρονομετρημένη επανάληψη. Ένα απενεργοποιημένο πρόγραμμα ή εξαντλημένο όριο μπορεί να απαιτεί αλλαγή λογαριασμού αντί αυτού, οπότε αυτή η κεφαλίδα δεν είναι πάντα παρούσα.503 protection_unavailable— Η αποθήκευση ή ο συντονισμός προστασίας API δεν είναι διαθέσιμη προσωρινά. Δοκιμάστε ξανά αργότερα; αυτό δεν αποτελεί αποτυχία πληρωμής ή χρέωση πίστωσης.
Διαχείριση γραμματοκιβωτίου
Ανάκτηση επιτρεπόμενων τομέων, δημιουργία ή εναλλαγή γραμματοκιβωτίων, επιλογή επιτρεπόμενων χρόνων ζωής και διαγραφή των ιδιόκτητων διευθύνσεων.
Λίστα επιτρεπόμενων τομέων
Λίστα διαθέσιμων τομέων για δημιουργία προσωρινών email. Φιλτράρετε ανά τύπο για να δείτε μόνο δωρεάν, premium ή προσαρμοσμένους τομείς που υποστηρίζονται από το πρόγραμμα συνδρομής σας.
| Παράμετρος | Τοποθεσία | Τύπος | Κατάσταση | Περιγραφή |
|---|---|---|---|---|
type
|
query | string | προαιρετικό |
Φίλτρο επιπέδου τομέα. Η παράλειψη χρησιμοποιεί όλα όταν η πρόσβαση premium-domain είναι ενεργοποιημένη, διαφορετικά δωρεάν. Αναγνωρισμένες τιμές: free, basic, pro, premium, custom, ultimate, all
Προεπιλογή:
Εξαρτάται από λογαριασμό
|
const response = await fetch('https://v1.tempmailg.com/api/domains?type=free', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/domains?type=free', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/domains?type=free');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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. |
Δημιουργία προσωρινού γραμματοκιβωτίου
Δημιουργήστε ένα ιδιόκτητο προσωρινό γραμματοκιβώτιο. Παραλείψτε το όνομα χρήστη και τον τομέα για τυχαία δημιουργία, ή παρέχετε ένα επιτρεπόμενο προσαρμοσμένο όνομα χρήστη και έναν επιτρεπόμενο τομέα. Η παράμετρος provider μπορεί να επιλέξει τη δημιουργία ψευδώνυμου Gmail ή Outlook.
| Παράμετρος | Τοποθεσία | Τύπος | Κατάσταση | Περιγραφή |
|---|---|---|---|---|
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 αντί να επιλέγουν σιωπηρά μια προεπιλογή.const response = await fetch('https://v1.tempmailg.com/api/emails', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.post('https://v1.tempmailg.com/api/emails', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/emails');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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. Οι αλλαγές ασφαλείας μπορούν να ανακαλέσουν την άδεια νωρίτερα. |
Ενημέρωση / Αλλαγή γραμματοκιβωτίου
Δημιουργήστε ή επιλέξτε ένα γραμματοκιβώτιο στο νέο όνομα χρήστη και τομέα μετά την επαλήθευση της ιδιοκτησίας του τρέχοντος γραμματοκιβωτίου. Αυτό δεν μετονομάζει το παλιό γραμματοκιβώτιο ούτε αλλάζει τη διάρκεια ζωής του στη θέση του. Όταν ο προορισμός διαφέρει, το παλιό γραμματοκιβώτιο παραμένει στο ιστορικό και μπορεί να παύσει λειτουργία λόγω περιορισμών ενεργών γραμματοκιβωτίων. Η επαναχρήση του δικού σας ενεργού προορισμού επαναεφαρμόζει τη ζητούμενη διάρκεια ζωής ή την προεπιλογή του σχεδίου.
| Παράμετρος | Τοποθεσία | Τύπος | Κατάσταση | Περιγραφή |
|---|---|---|---|---|
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>
|
lifetime (επιτρεπόμενες τιμές: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Παραλείψτε τη διάρκεια ζωής ή αφήστε την κενή, ώστε να χρησιμοποιηθεί η Προεπιλεγμένη Διάρκεια Ζωής Ηλεκτρονικού Ταχυδρομείου που έχει ρυθμιστεί για το τρέχον μηνιαίο/ετήσιο πρόγραμμα σας. Στείλτε μια επιτρεπόμενη διάρκεια ζωής, όπως 1h, για να παρακάμψετε αυτήν την προεπιλογή. Το Απεριόριστο χρησιμοποιείται μόνο όταν έχει ρυθμιστεί ως προεπιλογή του προγράμματος ή όταν ζητηθεί ρητά και επιτραπεί. Οι παράμετροι σώματος mailbox_lifetime και email_lifetime επίσης γίνονται αποδεκτές· η πρώτη μη κενή τιμή κερδίζει με τη σειρά: lifetime, mailbox_lifetime, email_lifetime. Οι μη έγκυρες ή μη επιτρεπτές τιμές επιστρέφουν HTTP 422 αντί να επιλέγουν σιωπηρά μια προεπιλογή.const response = await fetch('https://v1.tempmailg.com/api/emails/current@example.com/demo123/example.com', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.post('https://v1.tempmailg.com/api/emails/current@example.com/demo123/example.com', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/emails/current@example.com/demo123/example.com');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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. Οι αλλαγές ασφαλείας μπορούν να ανακαλέσουν την άδεια νωρίτερα. |
Διαγραφή γραμματοκιβωτίου
Διαγράψτε ένα ιδιόκτητο γραμματοκιβώτιο και ενεργοποιήστε τον καθαρισμό των μηνυμάτων και των αρχείων του. Τα διατηρημένα αρχεία γραμματοκιβωτίου ενδέχεται να διαγραφούν εσωτερικά με ήπιο τρόπο· η διεύθυνση δεν είναι πλέον διαθέσιμη μέσω του API.
| Παράμετρος | Τοποθεσία | Τύπος | Κατάσταση | Περιγραφή |
|---|---|---|---|---|
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 χαρακτήρων. Επαναλάβετε το ίδιο αίτημα με το ίδιο κλειδί για να αποφύγετε διπλή εργασία.
|
const response = await fetch('https://v1.tempmailg.com/api/emails/demo123@example.com', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.delete('https://v1.tempmailg.com/api/emails/demo123@example.com', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/emails/demo123@example.com');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'DELETE',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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.
Δημιουργία ψευδώνυμου Gmail
Δημιουργήστε ένα νέο προσωρινό γραμματοκιβώτιο ψευδώνυμου Gmail που ανήκει στον πιστοποιημένο χρήστη.
| Παράμετρος | Τοποθεσία | Τύπος | Κατάσταση | Περιγραφή |
|---|---|---|---|---|
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 χαρακτήρων. Επαναλάβετε το ίδιο αίτημα με το ίδιο κλειδί για να αποφύγετε διπλή εργασία.
|
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 αντί να επιλέγουν σιωπηρά μια προεπιλογή.const response = await fetch('https://v1.tempmailg.com/api/gmail-alias/emails', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.post('https://v1.tempmailg.com/api/gmail-alias/emails', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/gmail-alias/emails');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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. Οι αλλαγές ασφαλείας μπορούν να ανακαλέσουν την άδεια νωρίτερα. |
Τομείς ψευδώνυμου Outlook
Ανάκτηση ενεργών τομέων ψευδώνυμων Outlook / Hotmail που είναι διαθέσιμοι για δημιουργία γραμματοκιβωτίου.
const response = await fetch('https://v1.tempmailg.com/api/outlook-alias/domains', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/outlook-alias/domains', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/outlook-alias/domains');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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 όταν είναι επιλέξιμη. |
Δημιουργία ψευδώνυμου Outlook
Δημιουργήστε ένα νέο προσωρινό γραμματοκιβώτιο ψευδώνυμου Outlook / Hotmail που ανήκει στον πιστοποιημένο χρήστη.
| Παράμετρος | Τοποθεσία | Τύπος | Κατάσταση | Περιγραφή |
|---|---|---|---|---|
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 χαρακτήρων. Επαναλάβετε το ίδιο αίτημα με το ίδιο κλειδί για να αποφύγετε διπλή εργασία.
|
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 αντί να επιλέγουν σιωπηρά μια προεπιλογή.const response = await fetch('https://v1.tempmailg.com/api/outlook-alias/emails', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.post('https://v1.tempmailg.com/api/outlook-alias/emails', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/outlook-alias/emails');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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/κειμένου και ροή συνημμένων.
Λίστα μηνυμάτων γραμματοκιβωτίου
Ανακτήστε τα διαθέσιμα σύνοψη μηνυμάτων και τα μεταδεδομένα του γραμματοκιβωτίου. Οι τυπικές σαρώσεις εισερχομένων επιστρέφουν μια πρόσφατη παρτίδα έως 25 μηνύματα· αυτό δεν είναι ένα σελιδοποιημένο endpoint πλήρους ιστορικού. Χρησιμοποιήστε GET /messages/{messageId} για πλήρη σώματα και συνημμένα.
| Παράμετρος | Τοποθεσία | Τύπος | Κατάσταση | Περιγραφή |
|---|---|---|---|---|
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>
|
const response = await fetch('https://v1.tempmailg.com/api/messages?email=demo123@example.com', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/messages?email=demo123@example.com', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/messages?email=demo123@example.com');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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: εάν υπάρχουν μεταδεδομένα συνημμένων. Η διαθεσιμότητα λήψης ελέγχεται ξεχωριστά. |
Λήψη Μονού Μηνύματος
Ανακτήστε ένα ιδιόκτητο μήνυμα με το αδιαφανές ID του μηνύματος. Επιστρέφει μορφές σώματος και μεταδεδομένα συνημμένων. Τα πεδία του σώματος εξαρτώνται από τη μορφή του μηνύματος· το Outlook προσθέτει πεδία ειδικά για τον πάροχο που αναφέρονται παρακάτω.
| Παράμετρος | Τοποθεσία | Τύπος | Κατάσταση | Περιγραφή |
|---|---|---|---|---|
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>
|
const response = await fetch('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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. |
Διαγραφή μηνύματος
Διαγράψτε ένα μόνο μήνυμα που ανήκει στον χρήστη.
| Παράμετρος | Τοποθεσία | Τύπος | Κατάσταση | Περιγραφή |
|---|---|---|---|---|
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 χαρακτήρων. Επαναλάβετε το ίδιο αίτημα με το ίδιο κλειδί για να αποφύγετε διπλή εργασία.
|
const response = await fetch('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.delete('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'DELETE',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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. |
Λήψη συνημμένου
Κατεβάστε μια συνημμένη αρχείο από ένα μήνυμα που ανήκει σε εσάς.
| Παράμετρος | Τοποθεσία | Τύπος | Κατάσταση | Περιγραφή |
|---|---|---|---|---|
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>
|
const response = await fetch('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const blob = await response.blob();
const downloadUrl = window.URL.createObjectURL(blob);
const link = document.createElement('a');
link.href = downloadUrl;
link.download = 'file.txt';
document.body.appendChild(link);
link.click();
link.remove();
window.URL.revokeObjectURL(downloadUrl);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt', headers=headers, stream=True, timeout=30)
response.raise_for_status()
with open('file.txt', 'wb') as handle:
for chunk in response.iter_content(chunk_size=8192):
if chunk:
handle.write(chunk)
<?php
$fileHandle = fopen('file.txt', 'w');
$ch = curl_init('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_FILE => $fileHandle,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
if (curl_exec($ch) === false) {
fclose($fileHandle);
throw new RuntimeException(curl_error($ch));
}
curl_close($ch);
fclose($fileHandle);
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
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
Content-Disposition |
header | Η επιτυχής απόκριση κατεβάζει το ζητούμενο όνομα αρχείου. |
body |
binary | Τα bytes του αρχείου σε επιτυχία, όχι JSON. Τα σφάλματα επιστρέφουν JSON με κατάσταση μη-2xx. |
Όρια Ρυθμού & Ποσοστώσεις
Παρακολουθήστε σε πραγματικό χρόνο τους προϋπολογισμούς αιτήσεων, τα όρια ταχύτητας και τις ποσότητες λογαριασμού χωρίς να καταναλώνετε μονάδες.
Όριο Ρυθμού & Ποσό
Ελέγξτε το τρέχον όριο ταχύτητας και την κατάσταση του quota χωρίς να καταναλώνετε καμία χρήση API. Αυτό το σημείο τελικού είναι χωρίς quota και δεν αφαιρεί μηνιαίες πιστώσεις API (όριο προστασίας κατά κακής χρήσης: 60 αιτήματα/λεπτό).
const response = await fetch('https://v1.tempmailg.com/api/rate-limit', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/rate-limit', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/rate-limit');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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· μην το προσθέσετε ξανά κατά τον υπολογισμό των υπολοίπων. |
Webhooks για τα Ταχυδρομεία (Αποστολή σε Εchtzeit)
Αντί να ελέγχετε επανειλημμένα την API REST (GET /messages) για να ελέγξετε αν υπάρχουν εισερχόμενα μηνύματα, ρυθμίστε τις Webhooks για να στείλετε τα νέα μηνύματα στο δικό σας server ή σε ροές αυτοματοποίησης σε πραγματικό χρόνο.
Υποστηριζόμενα γεγονότα Webhook
Κάθε webhook μπορεί να υπογράφει μία ή περισσότερες κατηγορίες γεγονότων. Το endpoint σας λαμβάνει ειδοποίηση για γεγονός όταν ένα από αυτά εκτελείται.
Αποστέλλεται σε πραγματικό χρόνο κάθε φορά που ένα νέο μήνυμα φθάνει στο επιλεγμένο γραμματοκιβώτιο.
Αποστέλλεται όταν λήγει το προσωρινό γραμματοκιβώτιο και η επεξεργασία του webhook παύει.
Αποστέλλεται όταν ένα ληγμένο γραμματοκιβώτιο ενεργοποιείται ξανά σύμφωνα με τους κανόνες του σχεδίου.
Αποστέλλεται ακριβώς πριν το webhook και το γραμματοκιβώτιό του διαγραφούν.
Αίτημα Ετικετών & Επαλήθευση Υπογραφής HMAC
Κάθε αποστολή webhook περιέχει ειδικά κεφάλαια ασφαλείας. Χρησιμοποιήστε το κεφάλαιο X-TempMailg-Signature για να επιβεβαιώσετε ότι οι εισερχόμενες αιτήσεις αποστάλθηκαν αυθεντικά από το TempMailg και δεν έχουν τροποποιηθεί.
| Όνομα Ετικέτας | Παράδειγμα Αξίας | Περιγραφή |
|---|---|---|
User-Agent |
TempMailg-Webhooks/1.0 | Τυπικό αναγνωριστικό για τον εργαζόμενο παράδοσης webhook. |
X-TempMailg-Event |
email.received | Ο τύπος του γεγονότος που προκάλεσε αυτήν την παράδοση. |
X-TempMailg-Event-Id |
e7b1a2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c | Μοναδικό UUID που έχει εκχωρηθεί σε αυτήν την προσπάθεια παράδοσης. |
X-TempMailg-Timestamp |
1725192000 | Χρονική σήμανση Unix epoch που υποδεικνύει πότε ξεκίνησε το αίτημα. |
X-TempMailg-Signature |
sha256=d7a8fbb307d7809469ca933b02d82941... | HMAC-SHA256 υπογραφή υπολογισμένη από {timestamp}.{raw_body} χρησιμοποιώντας το μυστικό σας. |
X-TempMailg-Test |
false | Αληθές όταν αποστέλλεται από τη λειτουργία "Send Test Ping" στον πίνακα ελέγχου σας. |
Η υπογραφή υπολογίζεται χρησιμοποιώντας HMAC με SHA256 πάνω στη σειρά χαρακτήρων:
hash_hmac('sha256', "${X-TempMailg-Timestamp}.${raw_request_body}", your_webhook_secret)
Παράδειγμα Περιεχομένου Συγχρονισμού (email.received)
Παραδίδεται ως application/json στο σώμα της HTTP POST αίτησης.
{
"id": "e7b1a2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"version": "1.0",
"event": "email.received",
"occurred_at": "2026-11-19T02:18:11+00:00",
"test": false,
"mailbox": {
"id": 1024,
"email": "developer@v1.tempmailg.com"
},
"data": {
"message_id": "7a8b9c0d1e2f",
"subject": "Your Verification Code: 948201",
"from": "auth@service.com",
"to": "developer@v1.tempmailg.com",
"date": "2026-11-19T02:18:11+00:00",
"attachments_count": 0,
"text_preview": "Hello, your one-time verification code is 948201. It will expire in 10 minutes.",
"email_url": "https://tempmailg.com/mailbox/1024?message=7a8b9c0d1e2f",
"inbox_url": "https://tempmailg.com/mailbox/1024"
}
}
Παραδείγματα Υλοποίησης Παραλήπτη
Επιλέξτε τη γλώσσα σας για να δείτε πώς να λαμβάνετε webhooks και να επαληθεύετε τις υπογραφές HMAC με ασφάλεια.
const express = require('express');
const crypto = require('crypto');
const app = express();
const WEBHOOK_SECRET = 'your_webhook_signing_secret';
// Capture raw body buffer for HMAC-SHA256 signature verification
app.use(express.json({
verify: (req, res, buf) => {
req.rawBody = buf.toString('utf8');
}
}));
app.post('/webhook', (req, res) => {
const timestamp = req.headers['x-tempmailg-timestamp'];
const signatureHeader = req.headers['x-tempmailg-signature'] || '';
// Calculate HMAC-SHA256 signature
const expectedSignature = 'sha256=' + crypto
.createHmac('sha256', WEBHOOK_SECRET)
.update(`${timestamp}.${req.rawBody}`)
.digest('hex');
// Verify signature
if (signatureHeader !== expectedSignature) {
return res.status(401).json({ error: 'Invalid webhook signature' });
}
const { event, mailbox, data } = req.body;
console.log(`[Event: ${event}] Mailbox: ${mailbox.email}`);
if (event === 'email.received') {
console.log(`From: ${data.from}`);
console.log(`Subject: ${data.subject}`);
console.log(`Preview: ${data.text_preview}`);
}
// Acknowledge receipt with HTTP 200
res.status(200).json({ received: true });
});
app.listen(3000, () => console.log('Webhook receiver running on port 3000'));
from flask import Flask, request, jsonify
import hmac
import hashlib
app = Flask(__name__)
WEBHOOK_SECRET = b"your_webhook_signing_secret"
@app.route("/webhook", methods=["POST"])
def handle_webhook():
timestamp = request.headers.get("X-TempMailg-Timestamp", "")
signature_header = request.headers.get("X-TempMailg-Signature", "")
# Calculate expected HMAC-SHA256 signature
raw_body = request.get_data()
signed_payload = f"{timestamp}.".encode("utf-8") + raw_body
expected_signature = "sha256=" + hmac.new(
WEBHOOK_SECRET, signed_payload, hashlib.sha256
).hexdigest()
# Verify signature securely
if not hmac.compare_digest(signature_header, expected_signature):
return jsonify({"error": "Invalid signature"}), 401
payload = request.get_json()
event = payload.get("event")
mailbox = payload.get("mailbox", {}).get("email")
data = payload.get("data", {})
print(f"[{event}] Mailbox: {mailbox}")
if event == "email.received":
print(f"From: {data.get('from')}")
print(f"Subject: {data.get('subject')}")
print(f"Preview: {data.get('text_preview')}")
# Return 200 OK to acknowledge receipt
return jsonify({"received": True}), 200
if __name__ == "__main__":
app.run(port=5000)
<?php
$secret = 'your_webhook_signing_secret';
$rawBody = file_get_contents('php://input');
$timestamp = $_SERVER['HTTP_X_TEMPMAILG_TIMESTAMP'] ?? '';
$receivedSignature = $_SERVER['HTTP_X_TEMPMAILG_SIGNATURE'] ?? '';
// Calculate HMAC-SHA256 signature
$expectedSignature = 'sha256=' . hash_hmac('sha256', $timestamp . '.' . $rawBody, $secret);
// Verify signature
if (!hash_equals($expectedSignature, $receivedSignature)) {
http_response_code(401);
echo json_encode(['error' => 'Invalid signature']);
exit;
}
$payload = json_decode($rawBody, true);
$event = $payload['event'] ?? '';
$mailbox = $payload['mailbox']['email'] ?? '';
$data = $payload['data'] ?? [];
if ($event === 'email.received') {
$sender = $data['from'] ?? '';
$subject = $data['subject'] ?? '';
$preview = $data['text_preview'] ?? '';
// Process new incoming email...
}
// Acknowledge receipt
http_response_code(200);
echo json_encode(['received' => true]);
Υποστηριζόμενες Πλατφόρμες & Ενσωματώσεις Αυτοματοποίησης
TempMailg Webhooks λειτουργούν αμέσως με τυπικά σημεία τερματισμού HTTPS και κορυφαίες πλατφόρμες χωρίς κώδικα/αυτοματοποίησης:
Συχνά λάθη και αντιμετώπιση προβλημάτων
Αυτά είναι οι πιο συχνοί κωδικοί απόκρισης που μπορείτε να δείτε ενώ ενσωματώνετε το API χρήστη.
Μη έγκυρο, ελλιπές ή ανακληθέν διακριτικό Bearer.
Η ιδιοκτησία, τα δικαιώματα λειτουργίας, η πρόσβαση στο domain ή το μέγεθος συνημμένου εμπόδισαν τη λειτουργία. Ελέγξτε τον κωδικό απόκρισης και το μήνυμα.
Ο πόρος δεν βρέθηκε στο επιτρεπόμενο host ή δεν ανήκει στον χρήστη.
Το κλειδί λειτουργίας χρησιμοποιήθηκε ξανά με διαφορετικές λεπτομέρειες, υπάρχει άλλη λειτουργία σε εκκρεμότητα ή η ασφάλεια του γραμματοκιβωτίου άλλαξε. Ελέγξτε τον κώδικα πριν προσπαθήσετε ξανά.
Το mailbox έχει λήξει ή είναι ανενεργό.
Μη έγκυρες παράμετροι, μη επιτρεπτός χρόνος ζωής, μη διαθέσιμη χωρητικότητα ψευδώνυμου, μη έγκυρη ρύθμιση PIN ή ένα ελλιπές/μη έγκυρο Idempotency-Key εμπόδισαν τη λειτουργία.
Ένα προστατευμένο γραμματοκιβώτιο χρειάζεται ένα έγκυρο token X-Mailbox-Unlock με περιορισμένο πεδίο. Χρησιμοποιήστε το action και το target_id από την απάντηση για διαγραφή. Πρέπει να επιλυθούν οι απαιτήσεις κλειδώματος ή ανάκτησης πριν από την επανάληψη.
Ένα όριο αιτήματος, απενεργοποιημένο πλάνο, εξαντλημένο όριο ή χρόνος ψύξης εμπόδισε τη λειτουργία. Ελέγξτε τον λόγο και τις κεφαλίδες διαθέσιμου προϋπολογισμού. Το Retry-After είναι προαιρετικό.
Ο διακομιστής δεν μπόρεσε να ολοκληρώσει τη λειτουργία. Για προστατευμένη δημιουργία ή διαγραφή, διατηρήστε το ίδιο αίτημα και το Idempotency-Key κατά την επανάληψη.
Δεν ήταν δυνατή η επαλήθευση της αποθήκευσης προστασίας ή του συντονισμού. Δοκιμάστε ξανά μετά την υποδεικνυόμενη καθυστέρηση. Αυτή η απάντηση δεν αποτελεί αποτυχημένη πληρωμή.
Γρήγορη λίστα ελέγχου
- 401 Unauthorized - Το token Bearer λείπει, είναι λάθος, έχει ανακληθεί ή έχει αντιγραφεί λανθασμένα.
- 403 Forbidden - Το τρέχον σχέδιο δεν έχει δικαίωμα πρόσβασης API χρήστη αυτή τη στιγμή.
- 404 Not Found - Πηγή δεδομένων δεν βρέθηκε ή παράμετρος είναι άκυρη
- 410 Gone / Expired - Το mailbox έχει λήξει ή δεν είναι πλέον ενεργό.
- 429 Rate Limited - Ελέγξτε τον λόγο απόκρισης και τις κεφαλίδες προϋπολογισμού. Το Retry-After ισχύει μόνο για χρονικά όρια· εξαντλημένα credits ή απενεργοποιημένη πρόσβαση μπορεί να απαιτούν αλλαγή λογαριασμού.
Συνιστώμενο επόμενο βήμα
Εάν έχετε συνδεθεί, ανοίξτε πρώτα τη Διαχείριση API και επιβεβαιώστε την κατάσταση του κλειδιού, της ποσόστωσης, της πρόσβασης στο σχέδιο και την ακριβή Βασική Διεύθυνση API Χρήστη πριν από την αποσφαλμάτωση της εξωτερικής εφαρμογής σας.