API dokumentáció

GPTMail API

A GPTMail API-val ideiglenes postafiókokat hozhatsz létre, leveleket listázhatsz és olvashatsz, valamint leveleket törölhetsz HTTPS-en keresztül, X-API-Key fejléccel. Automatizált tesztekhez, CI/CD folyamatokhoz és QA munkafolyamatokhoz ideális.

API Key beszerzése

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. lehetőség: Saját domain hozzáadása

A nyilvános domain sikeres MX-ellenőrzése után: bejelentkezés nélkül beküldve → API-kulcs (20000 kérés); bejelentkezve beküldve → 200 pont. Minden domain csak egy jutalmat kap. Fontos: csatlakozás után a domain utótagja nyilvános utótag lesz az oldal minden felhasználója számára, így mások is generálhatnak alatta címeket. Aktiválás után ne törölje, ne cserélje és ne módosítsa azt az MX rekordot, amely a domainet a szolgáltatásunkra mutat — különben a későbbi ellenőrzések hibásnak tekinthetik a beállítást. Ha az MX érvénytelennek bizonyul, a domain deaktiválódik. Ha az MX 3 egymást követő ellenőrzésnél is érvénytelen marad, a hozzá tartozó API Key is deaktiválódik. Ha az MX később újra érvényessé válik, a domain automatikusan újraaktiválódik.

Domainek

Nyilvános tesztkulcs

Teszteléshez küldd el az alább látható közös nyilvános kulcsot az X-API-Key fejlécben. A kulcs naponta változik, és napi 200 000 kéréses kerete van, amelyen az összes felhasználó osztozik.

Ma hátralévő

Nullázódik

Nyilvános kulcs élő kvótájának betöltése...

Az alábbi API-referencia Markdownként másolható AI-eszközökbe, tudásbázisokba vagy README-be.

Alap URL: https://mail.chatgpt.org.uk

AI
llms.txt

·

llms-full.txt

(Markdown)

Gyors kezdés

  • Az X-API-Key: YOUR_KEY a legegyszerűbb lehetőség. Gyors tesztekhez a YOUR_KEY helyett használd a fent látható napi nyilvános kulcsot.

  • A legtöbb postaláda-végpont email paramétert vár, pl. ?email=demo@example.com.

  • A GPTMail API válaszai JSON formátumúak success, data és error mezőkkel, API-kulcs használatakor pedig usage mezővel is. A Cloudflare hibái, köztük a kérésgyakoriság-korlát válaszai, HTML-t is visszaadhatnak. A JSON feldolgozása előtt ellenőrizd a HTTP-állapotkódot és a Content-Type fejlécet.

  • Ha már ismer egy támogatott domaint ezen az oldalon, nem kell először a generáló végpontot hívni. Helyben összerakhatja a prefix@domain címet és közvetlenül hívhatja a postaláda API-kat — egy kérést megspórol.

Kérésgyakoriság-korlátok és újrapróbálkozás

  • A GET és POST /api/generate-email közös korlátja forrás-IP-címenként 30 kérés 10 másodpercenként. Ez a nyilvános és a személyes API-kulcsokra egyaránt vonatkozik. Az ugyanazon IP-cím mögötti különböző kulcsok és kliensek osztoznak ezen a korláton.

  • A korlát túllépése HTTP 429 választ ad, és 10 másodpercre letiltja a címlétrehozást. Újrapróbálkozás előtt várd ki a Retry-After fejlécben megadott időt. Ha ez a fejléc hiányzik, várj legalább 10 másodpercet, majd növekvő időközönként próbálkozz újra. Kerüld az azonos IP-címet használó kliensek egyidejű újrapróbálkozását.

  • Ez a szabály nem vonatkozik a postafiók listázására és az egyes levelek olvasására. Az API-kulcsok napi és teljes kvótái ettől függetlenül érvényesek. A 10 másodperces várakozás nem állítja vissza a kimerült kulcskvótát.

Alapvető végpontok

POST / GET
/api/generate-email

Hozzon létre ideiglenes postaládát. Használja a GET metódust a legegyszerűbb véletlenszerű folyamathoz, vagy a POST-ot prefix és domain mezőkkel, ha pontosan szeretné szabályozni.

GET
/api/emails?email=...

E-mailek lekérése egy postaládához.

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

Egyetlen e-mail lekérése: szöveg, HTML, nyers fejlécek és metaadatok.

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

Egy e-mail törlése ID alapján.

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

Az összes e-mail törlése egy postaládában.

GET
/api/stats

Az egész oldal statisztikáinak olvasása.

Példafolyamat

Alább két gyakori minta: hagyja, hogy a szolgáltatás postaládát generáljon, vagy kérjen rögzített előtagot. Ha már ismer egy támogatott domaint, helyben is összerakhatja a címet és közvetlenül lekérdezheti.

1) Véletlenszerű ideiglenes e-mail-cím generálása

curl 'https://mail.chatgpt.org.uk/api/generate-email' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Példaválasz
{
  "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) Generálás rögzített előtaggal (pl. 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"}'
Példaválasz
{
  "success": true,
  "data": {
    "email": "demo@example.com"
  },
  "usage": {
    "daily_limit": 200000,
    "used_today": 2,
    "remaining_today": 199998
  }
}

3) E-mailek listázása egy postaládában

Ha már ismer egy támogatott domaint, hagyja ki az 1. lépést és kérdezzen közvetlenül.

curl 'https://mail.chatgpt.org.uk/api/emails?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Példaválasz
{
  "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) Egy e-mail olvasása — tartalmazza a sima szöveget, HTML törzset és metaadatokat

Cseréld le az EMAIL_ID-t a 3. lépésben kapott azonosítóra. Add meg a postafiók címét is email paraméterként (törlésnél és mellékletek letöltésénél is): így a levelet közvetlenül a postafiókjából olvassuk ki, nem azonosító alapján keressük. API kulccsal az email paraméter opcionális, de megadása gyorsítja a keresést.

curl 'https://mail.chatgpt.org.uk/api/email/EMAIL_ID?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Példaválasz
{
  "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) Egy e-mail törlése ID alapján

API kulccsal az email paraméter opcionális, de megadása gyorsítja a keresést.

curl -X DELETE 'https://mail.chatgpt.org.uk/api/email/EMAIL_ID?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Példaválasz
{
  "success": true,
  "data": {
    "message": "Email deleted"
  }
}

6) Teljes postaláda ürítése — törli az összes e-mailt ehhez a címhez

Minden hívás egy köteget töröl. Amíg a válaszban "has_more": true szerepel, hívd meg újra, amíg false értéket nem ad vissza.

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

Válasz szerkezete

A sikeres válaszok általában így néznek ki. API Key esetén figyelje a kvótát a usage mezőben.

{
  "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
  }
}

Bővített statisztikák

  • /api/statistics/24h egy 24 órás, óránkénti eloszlási ablakot ad vissza; korábbi ablakokhoz használd az offset=1,2,... értékeket.
  • /api/statistics/top-subjects a leggyakoribb levéltárgyakat adja vissza.
  • /api/statistics/top-domains visszaadja a legaktívabb domaineket.
  • /api/statistics/top-senders visszaadja a legaktívabb feladókat.
GPTMail