GPTMail API
Koristite GPTMail API za kreiranje privremenih sandučića, pregled i čitanje poruka te brisanje pošte preko HTTPS-a uz zaglavlje X-API-Key. Pogodan je za automatizovane testove, CI/CD procese i QA tokove rada.
Kako dobiti 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 requestsOpcija 2: Dodajte svoj domen
Nakon što javni domen prođe MX provjeru: poslan bez prijave → API ključ (20000 zahtjeva); poslan uz prijavu → 200 bodova. Svaki domen dobija samo jednu nagradu. Važno: nakon povezivanja sufiks tog domena postaje javni sufiks dostupan svim korisnicima ove stranice, pa i drugi korisnici mogu generisati adrese sandučića pod njim. Nakon aktivacije nemojte brisati, zamjenjivati niti mijenjati MX zapis koji ovaj domen usmjerava na našu uslugu. U suprotnom kasnije provjere mogu smatrati domen pogrešno konfigurisanim. Ako kasnija provjera utvrdi da MX zapis nije važeći, domen će biti deaktiviran. Ako MX zapis ostane nevažeći tokom 3 uzastopne provjere, povezani API ključ također će biti deaktiviran. Ako MX zapis kasnije ponovo postane važeći, domen će se automatski ponovo aktivirati.
Javni ključ za testiranje
Za testiranje pošaljite zajednički javni ključ prikazan ispod u zaglavlju X-API-Key. Ključ se mijenja svaki dan i ima dnevno ograničenje od 200.000 zahtjeva koje dijele svi korisnici.
Preostalo danas
Reset za
Učitavanje trenutne kvote za javni ključ...
API referencu ispod možete kopirati kao Markdown za AI alate, baze znanja ili README.
Osnovni URL: https://mail.chatgpt.org.uk
Brzi početak
X-API-Key: YOUR_KEYje najjednostavnija opcija. Za brze testove koristite dnevni javni ključ prikazan iznad umjestoYOUR_KEY.Većina endpointa sandučića zahtijeva parametar
email, na primjer?email=demo@example.com.Odgovori GPTMail API-ja koriste JSON s poljima
success,dataierror, teusagekada se koristi API ključ. Cloudflare greške, uključujući odgovore o ograničenju učestalosti, mogu umjesto toga vratiti HTML. Prije parsiranja JSON-a provjerite HTTP status i Content-Type.Ako već znate domen koji ova stranica trenutno podržava, ne morate prvo pozivati endpoint za generisanje e-mail adrese. Možete lokalno sastaviti
prefix@domaini direktno pozvati API-je sandučića, čime štedite jedan API zahtjev.
Ograničenja učestalosti i ponovni pokušaji
GET i POST /api/generate-email dijele ograničenje od 30 zahtjeva u 10 sekundi po izvornoj IP adresi. To važi i za javne i za lične API ključeve. Različiti ključevi i klijenti iza iste IP adrese dijele ovo ograničenje.
Prekoračenje ovog ograničenja vraća HTTP 429 i blokira generisanje e-mail adresa na 10 sekundi. Prije ponovnog pokušaja sačekajte onoliko koliko navodi Retry-After. Ako tog zaglavlja nema, sačekajte najmanje 10 sekundi, a zatim pokušajte ponovo s postepeno većim razmacima. Izbjegavajte istovremene ponovne pokušaje klijenata koji dijele IP adresu.
Ovo pravilo ne važi za pregled sandučića ni za čitanje pojedinačnih e-mailova. Dnevne i ukupne kvote API ključeva i dalje važe nezavisno. Čekanje od 10 sekundi ne obnavlja potrošenu kvotu ključa.
Glavni endpointi
/api/generate-emailGenerišite privremeni sandučić. Koristite GET za najjednostavniji slučajni tok ili POST s prefix i domain kada želite eksplicitnu kontrolu.
/api/emails?email=...Preuzmi email poruke za sandučić.
/api/email/{id}?email=...Preuzmi jedan email, uključujući tekst, HTML, sirova zaglavlja i metapodatke.
/api/email/{id}?email=...Obriši jedan email po ID-u.
/api/emails/clear?email=...Obriši sve email poruke u sandučiću.
/api/statsČitaj statistiku cijelog sajta.
Primjer toka
Ispod su dva uobičajena obrasca: neka servis generiše sandučić za vas ili zatražite fiksni prefiks. Ako već znate domen koji je trenutno podržan, adresu možete sastaviti i lokalno te je direktno upitati.
1) Generišite slučajnu privremenu email adresu
curl 'https://mail.chatgpt.org.uk/api/generate-email' \
-H 'X-API-Key: PUBLIC_API_KEY'Primjer odgovora
{
"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) Generišite s fiksnim prefiksom (npr. 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"}'Primjer odgovora
{
"success": true,
"data": {
"email": "demo@example.com"
},
"usage": {
"daily_limit": 200000,
"used_today": 2,
"remaining_today": 199998
}
}3) Lista email poruka u sandučiću
Ako već znate podržani domen, preskočite korak 1 i direktno pošaljite upit.
curl 'https://mail.chatgpt.org.uk/api/emails?email=demo@example.com' \
-H 'X-API-Key: PUBLIC_API_KEY'Primjer odgovora
{
"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) Čitanje jednog e-maila — uključuje čisti tekst, HTML sadržaj i metapodatke
Zamijenite EMAIL_ID id-jem vraćenim u koraku 3. Pošaljite i adresu sandučića kao email (i pri brisanju i preuzimanju priloga): tada se e-mail čita direktno iz svog sandučića umjesto da se traži po ID-u. Uz API ključ parametar email nije obavezan, ali njegovo slanje ubrzava pretragu.
curl 'https://mail.chatgpt.org.uk/api/email/EMAIL_ID?email=demo@example.com' \
-H 'X-API-Key: PUBLIC_API_KEY'Primjer odgovora
{
"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) Obrišite jedan email po ID-u
Uz API ključ parametar email nije obavezan, ali njegovo slanje ubrzava pretragu.
curl -X DELETE 'https://mail.chatgpt.org.uk/api/email/EMAIL_ID?email=demo@example.com' \
-H 'X-API-Key: PUBLIC_API_KEY'Primjer odgovora
{
"success": true,
"data": {
"message": "Email deleted"
}
}6) Ispraznite cijeli sandučić — briše sve email poruke za tu adresu
Svaki poziv briše jednu seriju. Dok odgovor sadrži "has_more": true, pozivajte ponovo dok ne vrati false.
curl -X DELETE 'https://mail.chatgpt.org.uk/api/emails/clear?email=demo@example.com' \
-H 'X-API-Key: PUBLIC_API_KEY'Primjer odgovora
{
"success": true,
"data": {
"message": "Deleted 3 emails",
"count": 3,
"has_more": false
}
}Oblik odgovora
Uspješni odgovori obično izgledaju ovako. Ako se autentifikujete API Keyem, obratite pažnju na informacije o kvoti unutar 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
}
}Proširena statistika
/api/statistics/24hvraća jedan 24-satni okvir raspodjele po satima; koristite offset=1,2,... za starije okvire./api/statistics/top-subjectsvraća najčešće naslove e-mail poruka./api/statistics/top-domainsvraća najaktivnije domene./api/statistics/top-sendersvraća najaktivnije pošiljaoce.