GPTMail API
Χρησιμοποιήστε το GPTMail API για να δημιουργείτε προσωρινά γραμματοκιβώτια, να εμφανίζετε και να διαβάζετε μηνύματα και να διαγράφετε αλληλογραφία μέσω HTTPS με την κεφαλίδα X-API-Key. Είναι κατάλληλο για αυτοματοποιημένες δοκιμές, ροές CI/CD και διαδικασίες QA.
Πώς να αποκτήσετε API Key
Buy API requests
Purchase API requests with GPTMail points. Earn points through daily check-ins and public domains, or buy points with LDC at a 1:1 rate.
Buy with points / add requestsΕπιλογή 2: Προσθέστε το δικό σας domain
Μετά την επαλήθευση MX ενός δημόσιου τομέα: υποβολή χωρίς σύνδεση → κλειδί API (20000 αιτήματα)· υποβολή με σύνδεση → 200 πόντοι. Κάθε τομέας λαμβάνει μία μόνο ανταμοιβή. Σημαντικό: μετά τη σύνδεση, το suffix του domain γίνεται δημόσιο suffix για όλους τους χρήστες του site, ώστε και άλλοι να δημιουργούν διευθύνσεις κάτω από αυτό. Μετά την ενεργοποίηση, μη διαγράφετε, μην αντικαθιστάτε και μην τροποποιείτε την εγγραφή MX που δείχνει το domain στην υπηρεσία μας — διαφορετικά μεταγενέστεροι έλεγχοι μπορεί να θεωρήσουν το domain εσφαλμένα ρυθμισμένο. Αν έλεγχος βρει το MX άκυρο, το domain απενεργοποιείται. Αν το MX παραμείνει άκυρο για 3 διαδοχικούς ελέγχους, απενεργοποιείται και το σχετικό API Key. Αν το MX γίνει ξανά έγκυρο, το domain επανενεργοποιείται αυτόματα.
Δημόσιο κλειδί για δοκιμές
Για δοκιμές, στείλτε το κοινόχρηστο δημόσιο κλειδί που εμφανίζεται παρακάτω στην κεφαλίδα X-API-Key. Αλλάζει κάθε μέρα και έχει ημερήσιο όριο 200.000 αιτημάτων, κοινό για όλους τους χρήστες.
Απομένει σήμερα
Επαναφορά σε
Φόρτωση live ποσοστώσεως για το δημόσιο κλειδί...
Η αναφορά API παρακάτω μπορεί να αντιγραφεί ως Markdown για εργαλεία AI, βάσεις γνώσης ή README.
Βασική διεύθυνση URL: https://mail.chatgpt.org.uk
Γρήγορη έναρξη
Η κεφαλίδα
X-API-Key: YOUR_KEYείναι η απλούστερη επιλογή. Για γρήγορες δοκιμές, χρησιμοποιήστε το ημερήσιο δημόσιο κλειδί που εμφανίζεται παραπάνω στη θέση τουYOUR_KEY.Τα περισσότερα endpoints γραμματοκιβωτίου απαιτούν την παράμετρο
email, π.χ.?email=demo@example.com.Οι αποκρίσεις του GPTMail API χρησιμοποιούν JSON με τα πεδία
success,dataκαιerror, καθώς καιusageόταν χρησιμοποιείται κλειδί API. Τα σφάλματα της Cloudflare, συμπεριλαμβανομένων των αποκρίσεων ορίου ρυθμού αιτημάτων, ενδέχεται να επιστρέφουν HTML. Ελέγξτε την κατάσταση HTTP και το Content-Type πριν αναλύσετε το JSON.Αν γνωρίζετε ήδη υποστηριζόμενο domain σε αυτό το site, δεν χρειάζεται πρώτα να καλέσετε το endpoint δημιουργίας. Μπορείτε να συνθέσετε τοπικά το
prefix@domainκαι να καλέσετε απευθείας τα API γραμματοκιβωτίου — εξοικονομείτε ένα request.
Όρια ρυθμού αιτημάτων και επαναλήψεις
Τα GET και POST /api/generate-email μοιράζονται όριο 30 αιτημάτων ανά 10 δευτερόλεπτα ανά διεύθυνση IP προέλευσης. Αυτό ισχύει τόσο για δημόσια όσο και για προσωπικά κλειδιά API. Διαφορετικά κλειδιά και πελάτες πίσω από την ίδια IP μοιράζονται αυτό το όριο.
Η υπέρβαση αυτού του ορίου επιστρέφει HTTP 429 και μπλοκάρει τη δημιουργία διευθύνσεων για 10 δευτερόλεπτα. Περιμένετε όσο ορίζει το Retry-After πριν δοκιμάσετε ξανά. Αν η κεφαλίδα αυτή λείπει, περιμένετε τουλάχιστον 10 δευτερόλεπτα και, στη συνέχεια, δοκιμάστε ξανά με αυξανόμενες καθυστερήσεις. Αποφύγετε ταυτόχρονες επαναλήψεις από πελάτες που μοιράζονται την ίδια IP.
Αυτός ο κανόνας δεν ισχύει για την εμφάνιση λίστας γραμματοκιβωτίου ή την ανάγνωση μεμονωμένων μηνυμάτων. Τα ημερήσια και συνολικά όρια των κλειδιών API εξακολουθούν να ισχύουν ανεξάρτητα. Η αναμονή 10 δευτερολέπτων δεν αποκαθιστά ένα εξαντλημένο όριο κλειδιού.
Βασικά endpoints
/api/generate-emailΔημιουργήστε προσωρινό εισερχόμενο. Χρησιμοποιήστε GET για την απλούστερη τυχαία ροή ή POST με prefix και domain όταν θέλετε ρητό έλεγχο.
/api/emails?email=...Λήψη email για ένα γραμματοκιβώτιο.
/api/email/{id}?email=...Λήψη ενός email: κείμενο, HTML, ακατέργαστες κεφαλίδες και μεταδεδομένα.
/api/email/{id}?email=...Διαγραφή ενός email κατά ID.
/api/emails/clear?email=...Διαγραφή όλων των email σε ένα γραμματοκιβώτιο.
/api/statsΑνάγνωση στατιστικών ολόκληρου του site.
Παράδειγμα ροής
Παρακάτω δύο συνηθισμένα μοτίβα: αφήστε την υπηρεσία να δημιουργήσει εισερχόμενο ή ζητήστε σταθερό prefix. Αν γνωρίζετε ήδη υποστηριζόμενο domain, μπορείτε να συνθέσετε τοπικά τη διεύθυνση και να το ερωτήσετε απευθείας.
1) Δημιουργία τυχαίας προσωρινής διεύθυνσης email
curl 'https://mail.chatgpt.org.uk/api/generate-email' \
-H 'X-API-Key: PUBLIC_API_KEY'Παράδειγμα απόκρισης
{
"success": true,
"data": {
"email": "a3f9c2b1@example.com"
},
"usage": {
"daily_limit": 200000,
"used_today": 1,
"remaining_today": 199999,
"total_limit": 200000,
"total_usage": 1,
"remaining_total": 199999
}
}2) Δημιουργία με σταθερό prefix (π.χ. demo@example.com)
curl -X POST 'https://mail.chatgpt.org.uk/api/generate-email' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: PUBLIC_API_KEY' \
-d '{"prefix":"demo"}'Παράδειγμα απόκρισης
{
"success": true,
"data": {
"email": "demo@example.com"
},
"usage": {
"daily_limit": 200000,
"used_today": 2,
"remaining_today": 199998
}
}3) Λίστα email σε εισερχόμενο
Αν γνωρίζετε ήδη υποστηριζόμενο domain, παραλείψτε το βήμα 1 και ερωτήστε απευθείας.
curl 'https://mail.chatgpt.org.uk/api/emails?email=demo@example.com' \
-H 'X-API-Key: PUBLIC_API_KEY'Παράδειγμα απόκρισης
{
"success": true,
"data": {
"emails": [
{
"id": "e5a7f3...",
"email_address": "demo@example.com",
"from_address": "noreply@github.com",
"subject": "Your code: 654321",
"content": "Your verification code is 654321",
"html_content": "...",
"has_html": true,
"timestamp": 1709654321,
"created_at": "2024-03-05T12:18:41Z"
}
],
"count": 1
}
}4) Ανάγνωση ενός email — περιλαμβάνει απλό κείμενο, σώμα HTML και μεταδεδομένα
Αντικαταστήστε το EMAIL_ID με ένα id που επιστράφηκε στο βήμα 3. Περάστε επίσης τη διεύθυνση του γραμματοκιβωτίου ως email (και για διαγραφές και λήψεις συνημμένων): τότε το μήνυμα διαβάζεται απευθείας από το γραμματοκιβώτιό του αντί να αναζητείται με βάση το ID. Με κλειδί API η παράμετρος email είναι προαιρετική, αλλά η αποστολή της κάνει την αναζήτηση ταχύτερη.
curl 'https://mail.chatgpt.org.uk/api/email/EMAIL_ID?email=demo@example.com' \
-H 'X-API-Key: PUBLIC_API_KEY'Παράδειγμα απόκρισης
{
"success": true,
"data": {
"id": "e5a7f3...",
"email_address": "demo@example.com",
"from_address": "noreply@github.com",
"subject": "Your code: 654321",
"content": "Your verification code is 654321",
"html_content": "<p>Your code is 654321</p>",
"has_html": true,
"timestamp": 1709654321,
"raw_size": 2048,
"created_at": "2024-03-05T12:18:41Z"
}
}5) Διαγραφή ενός email κατά ID
Με κλειδί API η παράμετρος email είναι προαιρετική, αλλά η αποστολή της κάνει την αναζήτηση ταχύτερη.
curl -X DELETE 'https://mail.chatgpt.org.uk/api/email/EMAIL_ID?email=demo@example.com' \
-H 'X-API-Key: PUBLIC_API_KEY'Παράδειγμα απόκρισης
{
"success": true,
"data": {
"message": "Email deleted"
}
}6) Καθαρισμός ολόκληρου εισερχομένου — διαγράφει όλα τα email για αυτή τη διεύθυνση
Κάθε κλήση διαγράφει μία παρτίδα. Όσο η απόκριση περιέχει "has_more": true, καλέστε ξανά μέχρι να επιστρέψει false.
curl -X DELETE 'https://mail.chatgpt.org.uk/api/emails/clear?email=demo@example.com' \
-H 'X-API-Key: PUBLIC_API_KEY'Παράδειγμα απόκρισης
{
"success": true,
"data": {
"message": "Deleted 3 emails",
"count": 3,
"has_more": false
}
}Μορφή απόκρισης
Οι επιτυχημένες αποκρίσεις συνήθως μοιάζουν έτσι. Με API Key, προσέξτε τις πληροφορίες ποσόστωσης στο usage.
{
"success": true,
"data": {
"email": "demo@example.com"
},
"usage": {
"daily_limit": 200000,
"used_today": 1,
"remaining_today": 199999,
"total_limit": 200000,
"total_usage": 1,
"remaining_total": 199999
}
}Εκτεταμένα στατιστικά
/api/statistics/24hεπιστρέφει ένα παράθυρο ωριαίας κατανομής 24 ωρών· χρησιμοποιήστε offset=1,2,... για παλαιότερα παράθυρα./api/statistics/top-subjectsεπιστρέφει τα συχνότερα θέματα μηνυμάτων./api/statistics/top-domainsεπιστρέφει τα πιο ενεργά domains./api/statistics/top-sendersεπιστρέφει τους πιο ενεργούς αποστολείς.