Documentația API

API-ul GPTMail

Folosiți API-ul GPTMail pentru a genera căsuțe de e-mail temporare, a lista și a citi mesaje și a șterge e-mailuri prin HTTPS, cu antetul X-API-Key. Este potrivit pentru teste automate, pipeline-uri CI/CD și fluxuri de lucru QA.

Cum obții un 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

Opțiunea 2: Adaugă propriul domeniu

După verificarea MX a unui domeniu public: trimis fără autentificare → cheie API (20000 cereri); trimis cu autentificare → 200 de puncte. Fiecare domeniu primește o singură recompensă. Important: odată conectat, sufixul domeniului devine sufix public pentru toți utilizatorii site-ului, astfel că și alții pot genera adrese sub el. După activare, nu șterge, nu înlocui și nu modifica înregistrarea MX care indică domeniul către serviciul nostru — altfel verificările ulterioare pot considera domeniul configurat greșit. Dacă o verificare găsește MX invalid, domeniul este dezactivat. Dacă MX rămâne invalid la 3 verificări consecutive, și API Key-ul asociat este dezactivat. Dacă MX devine din nou valid, domeniul este reactivat automat.

Domenii

Cheie publică de testare

Pentru testare, trimiteți cheia publică partajată afișată mai jos în antetul X-API-Key. Aceasta se schimbă în fiecare zi și are o limită zilnică de 200.000 de solicitări, comună tuturor utilizatorilor.

Rămas astăzi

Se resetează în

Se încarcă cota live pentru cheia publică...

Referința API de mai jos poate fi copiată ca Markdown pentru instrumente AI, baze de cunoștințe sau un README.

URL de bază: https://mail.chatgpt.org.uk

AI
llms.txt

·

llms-full.txt

(Markdown)

Start rapid

  • X-API-Key: YOUR_KEY este cea mai simplă opțiune. Pentru teste rapide, folosiți cheia publică zilnică afișată mai sus în locul YOUR_KEY.

  • Majoritatea endpoint-urilor de cutie poștală necesită parametrul email, de ex. ?email=demo@example.com.

  • Răspunsurile API GPTMail folosesc JSON cu câmpurile success, data și error, plus usage când se folosește o cheie API. Erorile Cloudflare, inclusiv răspunsurile la depășirea limitei de frecvență, pot returna în schimb HTML. Verificați starea HTTP și Content-Type înainte de a parsa JSON-ul.

  • Dacă știi deja un domeniu suportat pe acest site, nu trebuie să apelezi mai întâi endpoint-ul de generare. Poți compune local prefix@domain și apela direct API-urile cutiei poștale — economisești un request.

Limite de frecvență și reîncercări

  • GET și POST /api/generate-email au în comun o limită de 30 de solicitări la 10 secunde pentru fiecare IP sursă. Aceasta se aplică atât cheilor API publice, cât și celor personale. Chei și clienți diferiți aflați în spatele aceluiași IP împart această limită.

  • Depășirea acestei limite returnează HTTP 429 și blochează generarea de adrese de e-mail timp de 10 secunde. Așteptați durata indicată de Retry-After înainte de a reîncerca. Dacă acest antet lipsește, așteptați cel puțin 10 secunde, apoi reîncercați cu pauze din ce în ce mai mari. Evitați reîncercările simultane ale clienților care folosesc același IP.

  • Această regulă nu se aplică listării căsuțelor sau citirii e-mailurilor individuale. Cotele zilnice și totale ale cheilor API se aplică în continuare, independent. Așteptarea de 10 secunde nu reface cota epuizată a unei chei.

Endpoint-uri principale

POST / GET
/api/generate-email

Generează o inbox temporar. Folosește GET pentru cel mai simplu flux aleatoriu sau POST cu prefix și domain când vrei control explicit.

GET
/api/emails?email=...

Preia e-mailurile pentru o cutie poștală.

GET
/api/email/{id}?email=...

Preia un singur e-mail: text, HTML, antete brute și metadate.

DELETE
/api/email/{id}?email=...

Șterge un e-mail după ID.

DELETE
/api/emails/clear?email=...

Șterge toate e-mailurile dintr-o cutie poștală.

GET
/api/stats

Citește statistici la nivel de site.

Flux exemplu

Mai jos sunt două tipare frecvente: lasă serviciul să genereze o inbox sau solicită un prefix fix. Dacă știi deja un domeniu suportat, poți compune local adresa și interoga direct.

1) Generează o adresă de e-mail temporară aleatorie

curl 'https://mail.chatgpt.org.uk/api/generate-email' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Exemplu de răspuns
{
  "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) Generare cu prefix fix (ex. 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"}'
Exemplu de răspuns
{
  "success": true,
  "data": {
    "email": "demo@example.com"
  },
  "usage": {
    "daily_limit": 200000,
    "used_today": 2,
    "remaining_today": 199998
  }
}

3) Listează e-mailurile dintr-o inbox

Dacă știi deja un domeniu suportat, sari peste pasul 1 și interoghează direct.

curl 'https://mail.chatgpt.org.uk/api/emails?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Exemplu de răspuns
{
  "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) Citește un singur e-mail — include text simplu, corp HTML și metadate

Înlocuiți EMAIL_ID cu un id returnat la pasul 3. Transmiteți și adresa căsuței ca email (inclusiv la ștergeri și la descărcarea atașamentelor): e-mailul este atunci citit direct din căsuța sa, în loc să fie căutat după ID. Cu o cheie API, parametrul email este opțional, dar trimiterea lui face căutarea mai rapidă.

curl 'https://mail.chatgpt.org.uk/api/email/EMAIL_ID?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Exemplu de răspuns
{
  "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) Șterge un e-mail după ID

Cu o cheie API, parametrul email este opțional, dar trimiterea lui face căutarea mai rapidă.

curl -X DELETE 'https://mail.chatgpt.org.uk/api/email/EMAIL_ID?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Exemplu de răspuns
{
  "success": true,
  "data": {
    "message": "Email deleted"
  }
}

6) Golește întreaga inbox — șterge toate e-mailurile pentru această adresă

Fiecare apel șterge un lot. Cât timp răspunsul conține "has_more": true, apelează din nou până când returnează false.

curl -X DELETE 'https://mail.chatgpt.org.uk/api/emails/clear?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Exemplu de răspuns
{
  "success": true,
  "data": {
    "message": "Deleted 3 emails",
    "count": 3,
    "has_more": false
  }
}

Forma răspunsului

Răspunsurile reușite arată de obicei astfel. Cu API Key, urmărește informațiile despre cotă din 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
  }
}

Statistici extinse

  • /api/statistics/24h returnează un interval de 24 de ore cu distribuția pe ore; folosiți offset=1,2,... pentru intervale mai vechi.
  • /api/statistics/top-subjects returnează subiectele de e-mail cele mai frecvente.
  • /api/statistics/top-domains returnează domeniile cele mai active.
  • /api/statistics/top-senders returnează expeditorii cei mai activi.
GPTMail