Dogfennaeth API

GPTMail API

Defnyddiwch API GPTMail i greu mewnflychau dros dro, rhestru a darllen negeseuon, a dileu post dros HTTPS gyda phennawd X-API-Key. Mae'n addas ar gyfer profion awtomataidd, piblinellau CI/CD a llifoedd gwaith QA.

Sut i gael 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

Opsiwn 2: Ychwanegwch eich parth eich hun

Ar ôl i barth cyhoeddus basio dilysiad MX: cyflwynwyd heb fewngofnodi → allwedd API (20000 cais); cyflwynwyd wedi mewngofnodi → 200 pwynt. Dim ond un wobr sydd i bob parth. Pwysig: unwaith y cysylltir, mae olrhain y parth hwnnw'n dod yn olrhain cyhoeddus i bob defnyddiwr ar y wefan hon, felly gall defnyddwyr eraill hefyd gynhyrchu cyfeiriadau blwch post oddi tano. Ar ôl actifadu, peidiwch â dileu, newid na newid y cofnod MX sy'n pwyntio'r parth hwn at ein gwasanaeth. Fel arall, gall gwiriadau diweddarach ystyried y parth yn gamgymeriad. Os bydd gwiriad yn darganfod y cofnod MX yn annilys, caiff y parth ei ddadactifadu. Os yw'r cofnod MX yn parhau'n annilys am 3 gwiriad yn olynol, caiff yr API Key cysylltiedig ei ddadactifadu hefyd. Os yw'r cofnod MX yn dod yn ddilys eto yn ddiweddarach, caiff y parth ei ailactifadu'n awtomatig.

Parthau

Allwedd brofi gyhoeddus

I brofi, anfonwch yr allwedd gyhoeddus a rennir a ddangosir isod ym mhennawd X-API-Key. Mae'n newid bob dydd ac mae ganddi derfyn dyddiol o 200,000 o geisiadau a rennir rhwng pob defnyddiwr.

Yn weddill heddiw

Ailosod mewn

Yn llwytho cwota byw ar gyfer yr allwedd gyhoeddus...

Gellir copïo'r cyfeirlyfr API isod fel Markdown ar gyfer offer AI, cronfeydd gwybodaeth neu README.

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

AI
llms.txt

·

llms-full.txt

(Markdown)

Cychwyn cyflym

  • X-API-Key: YOUR_KEY yw'r opsiwn symlaf. Ar gyfer profion cyflym, defnyddiwch yr allwedd gyhoeddus ddyddiol a ddangosir uchod yn lle YOUR_KEY.

  • Mae'r rhan fwyaf o bwyntiau blwch post yn gofyn am baramedr email, er enghraifft ?email=demo@example.com.

  • Mae ymatebion API GPTMail yn defnyddio JSON gyda'r meysydd success, data ac error, ynghyd â usage pan ddefnyddir allwedd API. Gall gwallau Cloudflare, gan gynnwys ymatebion terfyn cyfradd, ddychwelyd HTML yn lle hynny. Gwiriwch y statws HTTP a'r Content-Type cyn dosrannu JSON.

  • Os ydych eisoes yn gwybod parth a gefnogir ar y wefan hon, nid oes rhaid i chi alw'r pwynt cynhyrchu e-bost yn gyntaf. Gallwch lunio prefix@domain yn lleol a galw'r API blwch post yn uniongyrchol, sy'n arbed un API request.

Terfynau cyfradd ac ailgynnig

  • Mae GET a POST /api/generate-email yn rhannu terfyn o 30 cais fesul 10 eiliad ar gyfer pob cyfeiriad IP ffynhonnell. Mae hyn yn berthnasol i allweddi API cyhoeddus a phersonol. Mae allweddi a chleientiaid gwahanol y tu ôl i'r un IP yn rhannu'r terfyn hwn.

  • Mae mynd dros y terfyn hwn yn dychwelyd HTTP 429 ac yn rhwystro creu cyfeiriadau am 10 eiliad. Arhoswch am yr amser a nodir yn Retry-After cyn rhoi cynnig arall arni. Os nad yw'r pennawd hwn yn bresennol, arhoswch o leiaf 10 eiliad, yna rhowch gynnig arall arni gydag oedi cynyddol. Osgowch ailgynnig ar yr un pryd o gleientiaid sy'n rhannu IP.

  • Nid yw'r rheol hon yn berthnasol i restru negeseuon mewnflwch na darllen e-byst unigol. Mae cwotâu dyddiol a chyfan allweddi API yn dal i fod yn berthnasol ar wahân. Nid yw aros 10 eiliad yn adfer cwota allwedd sydd wedi'i ddihysbyddu.

Pwyntiau craidd

POST / GET
/api/generate-email

Cynhyrchwch flwch derbyn dros dro. Defnyddiwch GET ar gyfer y llif mewnflwch ar hap symlaf, neu POST gyda prefix a domain pan fyddwch eisiau rheolaeth benodol.

GET
/api/emails?email=...

Nôl e-byst ar gyfer blwch post.

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

Nôl un e-bost, gan gynnwys testun, HTML, pennynnau crai a metadata.

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

Dileu un e-bost yn ôl ID.

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

Dileu pob e-bost mewn blwch post.

GET
/api/stats

Darllen ystadegau ar draws y wefan.

Llif enghreifftiol

Isod mae dau batrwm cyffredin: gadael i'r gwasanaeth gynhyrchu blwch derbyn i chi, neu ofyn am prefix sefydlog. Os ydych eisoes yn gwybod parth a gefnogir ar hyn o bryd, gallwch hefyd lunio'r blwch post yn lleol a'i hol yn uniongyrchol.

1) Cynhyrchu cyfeiriad e-bost dros dro ar hap

curl 'https://mail.chatgpt.org.uk/api/generate-email' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Enghraifft o ymateb
{
  "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) Cynhyrchu gyda phrefix sefydlog (e.e. 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"}'
Enghraifft o ymateb
{
  "success": true,
  "data": {
    "email": "demo@example.com"
  },
  "usage": {
    "daily_limit": 200000,
    "used_today": 2,
    "remaining_today": 199998
  }
}

3) Rhestru e-byst mewn blwch derbyn

Os ydych yn gwybod parth a gefnogir, hepgor cam 1 a holwch yn uniongyrchol.

curl 'https://mail.chatgpt.org.uk/api/emails?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Enghraifft o ymateb
{
  "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) Darllen un e-bost — yn cynnwys testun plaen, corff HTML a metadata

Rhowch id a ddychwelwyd yng ngham 3 yn lle EMAIL_ID. Anfonwch gyfeiriad y mewnflwch fel email hefyd (gan gynnwys wrth ddileu a llwytho atodiadau i lawr): yna caiff yr e-bost ei ddarllen yn uniongyrchol o'i fewnflwch yn hytrach na'i chwilio yn ôl ID. Gydag allwedd API mae'r paramedr email yn ddewisol, ond mae ei anfon yn gwneud y chwilio'n gyflymach.

curl 'https://mail.chatgpt.org.uk/api/email/EMAIL_ID?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Enghraifft o ymateb
{
  "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) Dileu un e-bost yn ôl ID

Gydag allwedd API mae'r paramedr email yn ddewisol, ond mae ei anfon yn gwneud y chwilio'n gyflymach.

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

6) Clirio blwch derbyn cyfan — yn dileu pob e-bost ar gyfer y cyfeiriad hwn

Mae pob galwad yn dileu un swp. Tra bo'r ymateb yn cynnwys "has_more": true, galwch eto nes iddo ddychwelyd false.

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

Siâp yr ymateb

Mae ymatebion llwyddiannus fel arfer yn edrych fel hyn. Os ydych yn dilysu gydag API Key, talwch sylw at wybodaeth cwota o fewn 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
  }
}

Ystadegau estynedig

  • /api/statistics/24h yn dychwelyd un ffenestr 24 awr o ddosbarthiad fesul awr; defnyddiwch offset=1,2,... ar gyfer ffenestri hŷn.
  • /api/statistics/top-subjects yn dychwelyd y pynciau e-bost mwyaf cyffredin.
  • /api/statistics/top-domains yn dychwelyd y parthau mwyaf gweithgar.
  • /api/statistics/top-senders yn dychwelyd yr anfonwyr mwyaf gweithgar.
GPTMail