API-skjøl

GPTMail API

Brúka GPTMail API til at stovna fyribils postkassar, vísa og lesa boð og strika post umvegis HTTPS við einum X-API-Key-høvdi. Tað hóskar væl til sjálvvirkandi royndir, CI/CD-rørleiðingar og QA-arbeiðsgongdir.

Hvussu fær tú ein API-lykil

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

Møguleiki 2: Legg títt egna økisnavn afturat

Tá eitt alment økisnavn hevur staðið MX-kanningina: sent inn uttan innritan → API-lykil (20000 fyrispurningar); sent inn við innritan → 200 stig. Hvørt økisnavn fær bara eina løn. Týdningarmikið: tá ið økisnavnið er knýtt at, verður eftirskoytið eitt alment eftirskoyti, sum allir brúkarar á síðuni kunnu brúka, so aðrir brúkarar kunnu eisini stovna postkassaadressur undir tí. Eftir virkjanina mást tú ikki strika, skifta út ella broyta MX-skrásetingina, sum vísir hetta økisnavnið til okkara tænastu. Annars kunnu seinni kanningar meta økisnavnið sum skeivt sett upp. Um ein seinni kanning finnur, at MX-skrásetingin er ógildug, verður økisnavnið gjørt óvirkið. Um MX-skrásetingin er ógildug í 3 kanningum á rað, verður tilknýtti API-lykilin eisini gjørdur óvirkin. Verður MX-skrásetingin galdandi aftur seinni, verður økisnavnið sjálvvirkandi virkið aftur.

Økisnøvn

Almennur royndarlykil

Til royndir sendir tú felags almenna lykilin, sum víst er niðanfyri, í X-API-Key-høvdinum. Hann verður skiftur hvønn dag og hevur eitt dagligt hámark upp á 200.000 fyrispurningar, sum allir brúkarar deila.

Eftir í dag

Nullstillar eftir

Heintar dagførdu kvotuna fyri almenna lykilin...

API-yvirlitið niðanfyri kann avritast sum Markdown til AI-amboð, vitanargrunnar ella eitt README.

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

AI
llms.txt

·

llms-full.txt

(Markdown)

Skjótt byrjan

  • X-API-Key: YOUR_KEY er einfaldasti møguleikin. Til skjótar royndir kanst tú brúka dagliga almenna lykilin, sum víst er omanfyri, í staðin fyri YOUR_KEY.

  • Flest postkassa-endapunkt krevja ein email-parametur, t.d. ?email=demo@example.com.

  • Svar frá GPTMail API brúka JSON við teigunum success, data og error og harumframt usage, tá ið ein API-lykil verður brúktur. Cloudflare-feilir, eisini svar, tá ið markið fyri fyrispurningar er rokkið, kunnu í staðin geva HTML aftur. Kanna HTTP-støðuna og Content-Type, áðrenn tú tulkar JSON.

  • Um tú longu kennir eitt stuðlað økisnavn á hesi síðuni, er ikki neyðugt fyrst at kalla endapunktið, sum stovnar teldupostadressur. Tú kanst seta prefix@domain saman lokalt og kalla postkassa-API'ini beinleiðis, sum sparir ein API-fyrispurning.

Mørk fyri fyrispurningar og nýggjar royndir

  • GET og POST /api/generate-email deila eitt mark á 30 fyrispurningar fyri hvørji 10 sekund fyri hvørja keldu-IP. Hetta galdar bæði fyri almennar og persónligar API-lyklar. Ymiskir lyklar og klientar aftan fyri somu IP-adressu deila hetta markið.

  • Fer tú um hetta markið, verður HTTP 429 sent aftur, og stovnan av teldupostadressum verður forðað í 10 sekund. Bíða so leingi, sum Retry-After sigur, áðrenn tú roynir aftur. Um Retry-After manglar, bíða í minsta lagi 10 sekund, og royn so aftur við alsamt longri millumbilum. Forðast at royna aftur samstundis frá klientum, sum deila somu IP-adressu.

  • Hendan reglan galdar ikki, tá ið postkassin verður listaður ella einstøk teldubrøv verða lisin. Dagligu og samlaðu kvoturnar hjá API-lyklinum galda framvegis óheft av henni. At bíða í 10 sekund ger ikki eina uppbrúkta lykilkvotu tøka aftur.

Høvuðsendapunkt

POST / GET
/api/generate-email

Stovna ein fyribils postkassa. Brúka GET til einfaldasta tilvildarliga postkassaflæðið, ella POST við prefix og domain, tá ið tú vilt hava fult eftirlit.

GET
/api/emails?email=...

Heinta teldubrøv fyri ein postkassa.

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

Heinta eitt einstakt teldubræv, við teksti, HTML, rávum høvdum og metadátum.

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

Strika eitt teldubræv eftir ID.

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

Strika øll teldubrøv í einum postkassa.

GET
/api/stats

Les hagtøl fyri alla síðuna.

Dømisflæði

Niðanfyri eru tvey vanlig mynstur: lat tænastuna stovna ein postkassa til tín, ella bið um eitt fast forskoyti. Um tú longu kennir eitt stuðlað økisnavn, kanst tú eisini seta postkassaadressuna saman lokalt og spyrja beinleiðis.

1) Stovna eina tilvildarliga fyribils teldupostadressu

curl 'https://mail.chatgpt.org.uk/api/generate-email' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Dømi um svar
{
  "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) Stovna við føstum forskoyti (t.d. 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"}'
Dømi um svar
{
  "success": true,
  "data": {
    "email": "demo@example.com"
  },
  "usage": {
    "daily_limit": 200000,
    "used_today": 2,
    "remaining_today": 199998
  }
}

3) Lista teldubrøv í einum postkassa

Um tú kennir eitt stuðlað økisnavn, kanst tú leypa stig 1 um og spyrja beinleiðis.

curl 'https://mail.chatgpt.org.uk/api/emails?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Dømi um svar
{
  "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) Les eitt einstakt teldubræv — við reinum teksti, HTML-innihaldi og metadátum

Set eitt id, sum stig 3 skilaði, í staðin fyri EMAIL_ID. Send eisini adressuna á postkassanum sum email (eisini tá ið tú strikar og tekur viðhefti niður): so verður teldubrævið lisið beinleiðis úr postkassanum, í staðin fyri at tað verður leitað eftir tí við ID. Við einum API-lykli er email-parametururin valfríur, men at senda hann ger leitingina skjótari.

curl 'https://mail.chatgpt.org.uk/api/email/EMAIL_ID?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Dømi um svar
{
  "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) Strika eitt einstakt teldubræv eftir ID

Við einum API-lykli er email-parametururin valfríur, men at senda hann ger leitingina skjótari.

curl -X DELETE 'https://mail.chatgpt.org.uk/api/email/EMAIL_ID?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Dømi um svar
{
  "success": true,
  "data": {
    "message": "Email deleted"
  }
}

6) Rudda allan postkassan — strikar øll teldubrøv fyri hesa adressuna

Hvørt kall strikar ein bólk. Meðan svarið hevur "has_more": true, kalla aftur, til tað skilar false.

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

Svarsform

Væleydnað svar síggja vanliga soleiðis út. Um tú váttar teg við einum API-lykli, so hav eyga við kvotuupplýsingunum í 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
  }
}

Víðkaðar tølfrøði

  • /api/statistics/24h skilar einum 24 tíma tíðarbili við býti tíma fyri tíma; brúka offset=1,2,... fyri eldri tíðarbil.
  • /api/statistics/top-subjects skilar teimum vanligastu teldupostevnunum.
  • /api/statistics/top-domains skilar teimum mest virknu økisnøvnunum.
  • /api/statistics/top-senders skilar teimum mest virknu sendarunum.
GPTMail