API skjöl

GPTMail API

Notaðu GPTMail API til að búa til tímabundin pósthólf, birta lista yfir skilaboð, lesa þau og eyða pósti yfir HTTPS með X-API-Key-haus. Það hentar fyrir sjálfvirkar prófanir, CI/CD-ferla og QA-vinnuflæði.

Hvernig á að fá 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

Valkostur 2: Bættu við eigin léni

Þegar almennt lén stenst MX-staðfestingu: sent inn án innskráningar → API-lykill (20000 beiðnir); sent inn innskráður → 200 stig. Hvert lén fær aðeins eina umbun. Mikilvægt: þegar tenging er komin á, verður viðauki lénsins almennur viðauki fyrir alla notendur, svo aðrir geta líka búið til pósthólf undir honum. Eftir virkjun skal ekki eyða, skipta út eða breyta MX-færslu sem vísar léni til þjónustu okkar. Annars geta síðari athuganir talið lénið rangt stillt. Ef athugun finnur ógilda MX, verður lénið óvirkt. Ef MX er ógilt í 3 röðuðum athugunum, verður tengdur API lykill einnig óvirkur. Ef MX verður aftur gilt, verður lénið virkjað sjálfkrafa aftur.

Lén

Opinber prófunarlykill

Til prófunar skaltu senda sameiginlega opinbera lykilinn sem birtist hér að neðan í X-API-Key-hausnum. Hann breytist á hverjum degi og hefur daglegt hámark upp á 200.000 beiðnir sem allir notendur deila.

Eftir í dag

Endurstillt eftir

Hleð beinum kvóta fyrir almenna lykilinn...

API tilvísunina hér að neðan má afrita sem Markdown fyrir AI verkfæri, þekkingargrunn eða README.

Grunnslóð: https://mail.chatgpt.org.uk

AI
llms.txt

·

llms-full.txt

(Markdown)

Flýtiupphaf

  • X-API-Key: YOUR_KEY er einfaldasti kosturinn. Fyrir fljótlegar prófanir skaltu nota daglega opinbera lykilinn sem birtist hér að ofan í stað YOUR_KEY.

  • Flestar pósthólfsendapunktar krefjast breytunnar email, til dæmis ?email=demo@example.com.

  • Svör GPTMail API eru á JSON-sniði með reitunum success, data og error, auk usage þegar API-lykill er notaður. Villur frá Cloudflare, þar á meðal svör vegna hraðatakmarkana, geta skilað HTML í staðinn. Athugaðu HTTP-stöðuna og Content-Type áður en þú þáttar JSON.

  • Ef þú þekkir þegar studdan lén á þessari síðu þarftu ekki að kalla fyrst á tölvupóstgerðarendapunkt. Þú getur sett saman prefix@domain staðbundið og kallað beint á pósthólfs-API, sem sparar eina API-beiðni.

Hraðatakmarkanir og endurtilraunir

  • GET og POST /api/generate-email deila hámarki upp á 30 beiðnir á hverjum 10 sekúndum fyrir hverja upprunalega IP-tölu. Það gildir bæði um opinbera og persónulega API-lykla. Mismunandi lyklar og biðlarar á bak við sömu IP-tölu deila þessu hámarki.

  • Ef farið er yfir hámarkið skilar kerfið HTTP 429 og lokar á myndun netfanga í 10 sekúndur. Bíddu í þann tíma sem Retry-After gefur upp áður en þú reynir aftur. Ef sá haus vantar skaltu bíða í að minnsta kosti 10 sekúndur og reyna síðan aftur með sífellt lengri biðtíma. Forðastu samtímis endurtilraunir frá biðlurum sem deila IP-tölu.

  • Þessi regla gildir ekki um að birta lista yfir skilaboð í pósthólfi eða lesa einstök skilaboð. Daglegir kvótar og heildarkvótar API-lykla gilda áfram óháð þessu. Það endurheimtir ekki uppurinn kvóta lykils að bíða í 10 sekúndur.

Aðalendapunktar

POST / GET
/api/generate-email

Búðu til tímabundið pósthólf. Notaðu GET fyrir einfaldasta handahófskennda flæðið eða POST með prefix og domain þegar þú vilt skýra stjórn.

GET
/api/emails?email=...

Sæktu tölvupóst fyrir pósthólfið.

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

Sæktu einn tölvupóst, með texta, HTML, hráum höfðum og lýsigögnum.

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

Eyða einum tölvupósti eftir auðkenni.

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

Eyða öllum tölvupóstum í pósthólfinu.

GET
/api/stats

Lesa tölfræði fyrir allan vefinn.

Dæmi um flæði

Hér að neðan eru tvær algengar leiðir: láttu þjónustuna búa til pósthólf eða biðjið um fast forskeyti. Ef þú þekkir þegar studdan lén geturðu líka sett saman pósthólfið staðbundið og fyrirspurt beint.

1) Búðu til handahófskennt tímabundið netfang

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) Búðu til með föstu forskeyti (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) Listi tölvupósts í pósthólfi

Ef þú þekkir þegar studdan lén, slepptu skrefi 1 og spyrðu beint.

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) Lestu einn tölvupóst — inniheldur texta, HTML-líkama og lýsigögn

Skiptu EMAIL_ID út fyrir id sem skilaðist í skrefi 3. Sendu einnig netfang pósthólfsins sem email (líka þegar þú eyðir og sækir viðhengi): þá er pósturinn lesinn beint úr pósthólfi sínu í stað þess að vera leitaður uppi eftir ID. Með API-lykli er breytan email valkvæð, en ef hún er send verður leitin hraðari.

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) Eyða einum tölvupósti eftir auðkenni

Með API-lykli er breytan email valkvæð, en ef hún er send verður leitin hraðari.

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) Tæmdu allt pósthólf — eyðir öllum tölvupóstum fyrir þetta netfang

Hvert kall eyðir einni lotu. Á meðan svarið inniheldur "has_more": true skaltu kalla aftur þar til það 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
  }
}

Snið svars

Árangursrík svör líta venjulega svona út. Ef þú auðkennir með API lykli, athugaðu kvótaupplýsingar í 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
  }
}

Ítarleg tölfræði

  • /api/statistics/24h skilar einum 24 klukkustunda glugga með dreifingu eftir klukkustundum; notaðu offset=1,2,... fyrir eldri glugga.
  • /api/statistics/top-subjects skilar algengustu efnislínum tölvupósta.
  • /api/statistics/top-domains skilar virkustu léndin.
  • /api/statistics/top-senders skilar virkustu sendendum.
GPTMail