Doiciméadúchán API

GPTMail API

Úsáid API GPTMail chun boscaí isteach sealadacha a chruthú, teachtaireachtaí a liostú agus a léamh, agus ríomhphost a scriosadh thar HTTPS le ceanntásc X-API-Key. Oireann sé do thástálacha uathoibrithe, do phíblínte CI/CD agus do shreafaí oibre QA.

Conas API Key a fháil

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

Rogha 2: Cuir do fhearann féin leis

Tar éis d'fhearann poiblí fíorú MX a rith: curtha isteach gan logáil isteach → eochair API (20000 iarratas); curtha isteach agus tú logáilte isteach → 200 pointe. Ní fhaigheann gach fearann ach luach saothair amháin. Tá sé tábhachtach: nuair a nascfar é, éiríonn iarmhír an fhearainn sin ina iarmhír phoiblí do gach úsáideoir ar an suíomh seo, ionas gur féidir le húsáideoirí eile seoltaí bosca a ghiniúint faoi bhun freisin. Tar éis gníomhachtaithe, ná scrios, ná cuir in ionad, ná athraigh an taifead MX a dhíríonn an fearann seo chuig ár seirbhís. Ar shlí eile, féadfaidh seiceálacha níos déanaí an fearann a mheas míchumraithe. Má aimsíonn seiceáil níos déanaí an taifead MX neamhbhailí, díghníomhachtófar an fearann. Má fhanann an taifead MX neamhbhailí do 3 sheiceáil as a chéile, díghníomhachtófar an API Key gaolmhar freisin. Má éiríonn an taifead MX bailí arís ina dhiaidh sin, athghníomhachtófar an fearann go huathoibríoch.

Fearainn

Eochair phoiblí tástála

Le haghaidh tástála, seol an eochair phoiblí chomhroinnte a thaispeántar thíos sa cheanntásc X-API-Key. Athraíonn sí gach lá agus tá teorainn laethúil de 200,000 iarratas uirthi, a roinneann gach úsáideoir.

Fágtha inniu

Athshocrú i gceann

Cuóta beo don eochair phoiblí á lódáil...

Is féidir an tagairt API thíos a chóipeáil mar Markdown do uirlisí AI, bunachair eolais nó README.

Bun-URL: https://mail.chatgpt.org.uk

AI
llms.txt

·

llms-full.txt

(Markdown)

Tús tapa

  • Is é X-API-Key: YOUR_KEY an rogha is simplí. Le haghaidh tástálacha tapa, úsáid an eochair phoiblí laethúil a thaispeántar thuas in ionad YOUR_KEY.

  • Éilíonn an chuid is mó de chríochphointí bosca paraiméadar email, mar shampla ?email=demo@example.com.

  • Úsáideann freagraí API GPTMail JSON leis na réimsí success, data agus error, chomh maith le usage nuair a úsáidtear eochair API. D'fhéadfadh earráidí Cloudflare, lena n-áirítear freagraí teorann ráta, HTML a sheoladh ar ais. Seiceáil stádas HTTP agus Content-Type sula bparsálann tú JSON.

  • Má tá aithne agat cheana ar fhearann tacaithe ar an suíomh seo, ní gá duit an críochphointe ginte ríomhphoist a ghlaoch ar dtús. Is féidir leat prefix@domain a chumadh go háitiúil agus na APIanna bosca a ghlaoch go díreach, rud a shábháilann API request amháin.

Teorainneacha ráta agus atrialacha

  • Tá teorainn chomhroinnte de 30 n-iarratas in aghaidh 10 soicind, in aghaidh IP foinse, ag GET agus POST /api/generate-email. Baineann sí le heochracha API poiblí agus pearsanta araon. Roinneann eochracha agus cliaint éagsúla taobh thiar den IP céanna an teorainn seo.

  • Má sháraítear an teorainn, seoltar HTTP 429 ar ais agus cuirtear bac ar ghiniúint seoltaí ríomhphoist ar feadh 10 soicind. Fan ar feadh na tréimhse a shonraítear in Retry-After sula ndéanann tú atriail. Mura bhfuil an ceanntásc ann, fan 10 soicind ar a laghad agus méadaigh an mhoill idir atrialacha. Seachain atrialacha comhuaineacha ó chliaint a roinneann IP.

  • Ní bhaineann an riail seo le teachtaireachtaí sa bhosca isteach a liostú ná le ríomhphoist aonair a léamh. Tá cuótaí laethúla agus iomlána na heochrach API i bhfeidhm go neamhspleách. Ní athlíonann fanacht 10 soicind cuóta eochrach atá ídithe.

Críochphointí lárnacha

POST / GET
/api/generate-email

Gin bosca isteach sealadach. Úsáid GET don sreabhadh bosca randamach is simplí, nó POST le prefix agus domain nuair is mian leat rialú sonrach.

GET
/api/emails?email=...

Faigh ríomhphoist do bhosca.

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

Faigh aon ríomhphost amháin, lena n-áirítear téacs, HTML, ceanntásca amh agus meiteashonraí.

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

Scrios aon ríomhphost de réir ID.

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

Scrios gach ríomhphost i mbosca.

GET
/api/stats

Léigh staitisticí ar fud an tsuímh.

Sampla sreafa

Thíos tá dhá phatrún coitianta: lig don tseirbhís bosca a ghiniúint duit, nó iarr réimse réamhshocraithe. Má tá aithne agat cheana ar fhearann tacaithe faoi láthair, is féidir leat an bosca a chumadh go háitiúil agus ceist a chur go díreach air.

1) Gin seoladh ríomhphoist sealadach randamach

curl 'https://mail.chatgpt.org.uk/api/generate-email' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Sampla freagartha
{
  "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) Gin le réimse réamhshocraithe (m.sh. 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"}'
Sampla freagartha
{
  "success": true,
  "data": {
    "email": "demo@example.com"
  },
  "usage": {
    "daily_limit": 200000,
    "used_today": 2,
    "remaining_today": 199998
  }
}

3) Liostaigh ríomhphoist i mbosca isteach

Má tá fearann tacaithe aithnidiúil agat, scipeáil céim 1 agus fiosraigh go díreach.

curl 'https://mail.chatgpt.org.uk/api/emails?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Sampla freagartha
{
  "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) Léigh aon ríomhphost amháin — lena n-áirítear gnáth-théacs, corp HTML agus meiteashonraí

Cuir id a cuireadh ar ais i gcéim 3 in ionad EMAIL_ID. Cuir seoladh an bhosca isteach ar aghaidh mar email freisin (le haghaidh scriosta agus íoslódáil ceangaltán chomh maith): léitear an ríomhphost go díreach óna bhosca isteach ansin seachas é a chuardach de réir ID. Le heochair API, tá an paraiméadar email roghnach, ach má sheoltar é déantar an cuardach níos tapúla.

curl 'https://mail.chatgpt.org.uk/api/email/EMAIL_ID?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Sampla freagartha
{
  "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) Scrios aon ríomhphost de réir ID

Le heochair API, tá an paraiméadar email roghnach, ach má sheoltar é déantar an cuardach níos tapúla.

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

6) Glan bosca isteach iomlán — scriosann sé gach ríomhphost don seoladh seo

Scriosann gach glao baisc amháin. Fad is atá "has_more": true sa fhreagra, glaoigh arís go dtí go dtugann sé false ar ais.

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

Cuma an fhreagra

Breathnaíonn freagraí rathúla de ghnáth mar seo. Má fhíordheimhníonn tú le API Key, tabhair aird ar fhaisnéis chuóta laistigh de 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
  }
}

Staitisticí leathnaithe

  • /api/statistics/24h cuireann sé fuinneog 24 uair an chloig amháin den dáileadh in aghaidh na huaire ar ais; úsáid offset=1,2,... le haghaidh fuinneoga níos sine.
  • /api/statistics/top-subjects tugann sé na hábhair ríomhphoist is coitianta ar ais.
  • /api/statistics/top-domains a thugann na fearainn is gníomhaí ar ais.
  • /api/statistics/top-senders a thugann na seoltóirí is gníomhaí ar ais.
GPTMail