API resminamalary

GPTMail API

GPTMail API arkaly HTTPS we X-API-Key sözbaşysy bilen wagtlaýyn poçta gutularyny döredip, hatlary sanawlap we okap, şeýle hem hatlary pozup bilersiňiz. Ol awtomatik synaglar, CI/CD konweýerleri we QA iş akymlary üçin amatlydyr.

API Key nädip almaly

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-nji wariant: Öz domeniňizi goşuň

Jemgyýetçilik domeni MX barlagyndan geçenden soň: hasaba girmän iberilen → API açary (20000 haýyş); hasaba girip iberilen → 200 utuk. Her domen diňe bir sylag alýar. Möhüm: birikdirilenden soň, şol domen goşulmasy bu saýtyň ähli ulanyjylary üçin elýeterli açyk goşulma bolýar, şonuň üçin beýleki ulanyjylar hem onuň aşagynda poçta salgylaryny döredip bilerler. Işjeňleşdirilenden soň bu domeni biziň hyzmatymyza gönükdirýän MX ýazgysyny pozmaň, çalşyrmaň ýa-da üýtgetmäň. Ýogsa soňky barlaglar domeni nädogry sazlanan diýip hasaplap biler. Soňky barlag MX ýazgysyny nädogry diýip tapsa, domen öçüriler. MX ýazgysy yzygiderli 3 barlagda nädogry bolup galsa, degişli API açary hem öçüriler. MX ýazgysy soňra ýene dogry bolsa, domen awtomatik täzeden işjeňleşdiriler.

Domenler

Açyk synag açary

Synag üçin aşakda görkezilen umumy açyk açary X-API-Key sözbaşysynda iberiň. Ol her gün çalşylýar we ähli ulanyjylaryň bilelikde ulanýan gündelik 200,000 haýyş çägi bar.

Şu gün galan

Täzeden düzülýär

Jemgyýetçilik açary üçin janly kwota ýüklenýär...

Aşakdaky API salgysyny Markdown hökmünde AI gurallary, bilim bazalary ýa-da README üçin göçürip bilersiňiz.

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

AI
llms.txt

·

llms-full.txt

(Markdown)

Çalt başlangyç

  • X-API-Key: YOUR_KEY iň ýönekeý usuldyr. Çalt synaglar üçin YOUR_KEY ýerine ýokarda görkezilen gündelik açyk açary ulanyň.

  • Poçta gutusynyň endpointleriniň köpüsi email parametrini talap edýär, mysal üçin ?email=demo@example.com.

  • GPTMail API jogaplary success, data we error meýdanlary bolan JSON-y ulanýar, API açary ulanylanda bolsa usage hem goşulýar. Cloudflare ýalňyşlyklary, şol sanda haýyş ýygylygy çäkleriniň jogaplary, munuň ýerine HTML gaýtaryp biler. JSON-y derňemezden öň HTTP ýagdaýyny we Content-Type-y barlaň.

  • Bu saýtda häzirki wagtda goldanylýan domeni eýýäm bilýän bolsaňyz, ilki e-poçta döretmek endpointini çagyrmagyňyz hökman däl. prefix@domain salgysyny ýerli düzüp, poçta gutusy API-lerini göni çagyryp bilersiňiz, bu bir API haýyşyny tygşytlaýar.

Haýyş ýygylygynyň çäkleri we gaýtadan synanyşyklar

  • GET we POST /api/generate-email her çeşme IP salgysy üçin 10 sekuntda 30 haýyş umumy çägini paýlaşýar. Bu açyk we şahsy API açarlaryna degişlidir. Şol bir IP salgysynyň aňyrsyndaky dürli açarlar we müşderi programmalar bu çägi bilelikde ulanýar.

  • Bu çäkden geçilse HTTP 429 gaýtarylýar we e-poçta döretmek 10 sekuntlyk böwetlenýär. Täzeden synanyşmazdan öň Retry-After-de görkezilen wagta garaşyň. Eger bu sözbaşy ýok bolsa, azyndan 10 sekunt garaşyň, soňra aralygy kem-kemden artdyryp täzeden synanyşyň. Bir IP salgysyny paýlaşýan müşderi programmalaryň bir wagtda gaýtadan synanyşmagyndan gaça duruň.

  • Bu düzgün poçta gutusynyň sanawyna ýa-da aýry hatlary okamaga degişli däl. API açarlarynyň gündelik we jemi kwotalary garaşsyz hereket etmegini dowam etdirýär. 10 sekunt garaşmak gutaran açar kwotasyny dikeltmeýär.

Esasy endpointler

POST / GET
/api/generate-email

Wagtlaýyn poçta gutusyny dörediň. Iň ýönekeý tötänleýin poçta gutusy üçin GET ulanyň ýa-da takyk dolandyrmak isleseňiz, prefix we domain bilen POST ulanyň.

GET
/api/emails?email=...

Poçta gutusy üçin hatlary getiriň.

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

Bir haty getiriň: tekst, HTML, çala başlyklar we metadata.

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

ID boýunça bir haty pozuň.

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

Poçta gutusyndaky ähli hatlary pozuň.

GET
/api/stats

Sahypanyň ähli statistikasyny okaň.

Mysal akym

Aşakda iki ýygy ulanylýan usul bar: hyzmatyň siziň üçin gutu döretmegine rugsat beriň ýa-da belli prefiks soranyň. Goldanylýan domeni bilýän bolsaňyz, salgy ýerinde gurup göni sorap bilersiňiz.

1) Random wagtlaýyn e-poçta salgysyny döretmek

curl 'https://mail.chatgpt.org.uk/api/generate-email' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Jogap mysaly
{
  "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) Belli prefiks bilen döretmek (mes. 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"}'
Jogap mysaly
{
  "success": true,
  "data": {
    "email": "demo@example.com"
  },
  "usage": {
    "daily_limit": 200000,
    "used_today": 2,
    "remaining_today": 199998
  }
}

3) Poçta gutusyndaky hatlary sanamak

Goldanylýan domeni bilýän bolsaňyz, 1-nji ädimi geçiň we göni soraň.

curl 'https://mail.chatgpt.org.uk/api/emails?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Jogap mysaly
{
  "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) Bir haty okamak — ýönekeý tekst, HTML göwde we metadata

EMAIL_ID-ni 3-nji ädimde gaýtarylan id bilen çalşyň. Poçta gutusynyň salgysyny hem email hökmünde beriň (pozmakda we goşundylary ýüklemekde hem): şonda hat ID boýunça gözlenmän, göni öz poçta gutusyndan okalýar. API açary bilen email parametri hökmany däl, ýöne ony ibermek gözlegi çaltlandyrýar.

curl 'https://mail.chatgpt.org.uk/api/email/EMAIL_ID?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Jogap mysaly
{
  "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) ID boýunça bir haty pozmak

API açary bilen email parametri hökmany däl, ýöne ony ibermek gözlegi çaltlandyrýar.

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

6) Gutuny doly arassalamak — şu salgy üçin ähli hatlary pozýar

Her çagyryş bir topary pozýar. Jogapda "has_more": true bar wagty, false gaýtarýança ýene çagyryň.

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

Jogapyň görnüşi

Üstünlikli jogaplar adatça şeýle görünýär. API Key bilen girseňiz, usage içindäki kwotany üns beriň.

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

Giňeldilen statistika

  • /api/statistics/24h 24 sagatlyk bir sagatlaýyn paýlanyş penjiresini gaýtarýar; has köne penjireler üçin offset=1,2,... ulanyň.
  • /api/statistics/top-subjects iň köp gabat gelýän hat temalaryny gaýtarýar.
  • /api/statistics/top-domains iň işjeň domenleri gaýtarylýar.
  • /api/statistics/top-senders iň işjeň iberijileri gaýtarylýar.
GPTMail