Dokumantarii API

API GPTMail jedhamuun beekama

API GPTMail fayyadamuun HTTPS fi mataduree (header) X-API-Key tiin saanduqota galtee yeroo uumuu, ergaawwan tarreessuu fi dubbisuu, akkasumas imeelii haquu dandeessu. Qorannoo ofumaan hojjetuuf, sarara CI/CD fi hojii QA'f ni mijata.

Akkamitti argachuu 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

Filannoo 2: Domain keessan dabaluu

Domeenii uummataa mirkaneessa MX erga darbee: osoo hin seenin dhiyaate → furtuu API (gaaffii 20000); seenuun dhiyaate → qabxii 200. Domeeniin tokko badhaasa tokko qofa argata. Barbaachisaa: walitti qabsiifamee, domain suffix suffix ummataa marsariitti fayyadamtoota hunda ta'e, fayyadamtoonni biroos dandeessan sanduuqaa email mataa jala galchuu. Mallattoo booddee, MX rekordii marsariitti gargaarsa keenya irratti agarsiisan balleessi, jijjiirsi, ykn gulaali hin ta'in. Akkasumas, qormaanni booda domain dogoggora ta'uu ni danda'a. MX dogoggora yoo argame, domain dhaabbata. MX 3 qormaannoo waggaa waggaatti dogoggora yoo turte, API Key walqunnamtii dhaabbata. MX booda amala yoo ta'e, domain ofiisinnaan deebi'ama.

Domeenota

Furtuu qorannoo uummataa

Qorannoof, furtuu uummataa waloo armaan gaditti mul'atu mataduree X-API-Key keessatti ergaa. Guyyaa guyyaan jijjiirama, akkasumas daangaa guyyaa gaaffii 200,000 kan fayyadamtoota hundaaf waloo ta'e qaba.

Har'a hafe

Haaromsuu booda

Quota ummataa argachaa jalqaba...

API gadi fageenya Markdown ta'ee AI, odeeffannoo, ykn README irratti maxxansuu danda'a.

URL bu'uuraa: https://mail.chatgpt.org.uk

AI
llms.txt

·

llms-full.txt

(Markdown)

Jalqaba salpha

  • X-API-Key: YOUR_KEY filannoo salphaadha. Qorannoo saffisaaf, bakka YOUR_KEY furtuu uummataa guyyaa armaan olitti mul'atu fayyadamaa.

  • Xumurawwanwwan sanduuqaa hedduu email barbaadu, fakkeenya ?email=demo@example.com.

  • Deebiin API GPTMail JSON fayyadama; dirreewwan success, data fi error qaba; furtuun API yoo fayyadame usage dabalata. Dogoggoroonni Cloudflare, deebii daangaa gaaffii dabalatee, HTML deebisuu danda'u. JSON hiikuu dura haala HTTP fi Content-Type mirkaneessaa.

  • Domain ammallee beektu yoo ta'e, email uumuu dura xumuraa hin barbaachisu. prefix@domain keessatti mijeessuun sanduuqaa API irratti tooraan waamuu dandeessa; gaafachaa API tokko ol'aana.

Daangaa saffisaa fi irra deebi'anii yaaluu

  • GET fi POST /api/generate-email IP madda tokko tokkoof sekondii 10 keessatti gaaffii 30 daangaa waloo qabu. Kun furtuuwwan API uummataa fi dhuunfaa lamaanuu irratti hojjeta. Furtuuwwan fi maamiltoonni adda addaa IP tokko duuba jiran daangaa kana waliin qooddatu.

  • Daangaa kana darbuun HTTP 429 deebisa; teessoo imeelii uumuu sekondii 10 dhorka. Irra deebi'anii yaaluu dura yeroo Retry-After keessatti ibsame eegaa. Mata-dureen kun yoo hin jirre, yoo xiqqaate sekondii 10 eegaa; achiis yeroo eegumsaa dabaluun irra deebi'aa yaalaa. Maamiltoonni IP tokko qooddatan yeroo tokkotti irra deebi'anii yaaluu haa dhiisan.

  • Seerri kun tarreeffama saanduqa galtee ykn imeelii tokko tokkoon dubbisuu irratti hin hojjetu. Daangaan guyyaa fi waliigalaa furtuuwwan API ammas addatti hojjeta. Sekondii 10 eeguun daangaa furtuu dhumate hin deebisu.

Xumurawwanwwan ijoo

POST / GET
/api/generate-email

Sanduuqaa email yeroo gaggaafaa uumsi. GET fayyadamti karaa salpha garii, ykn POST waliin prefix fi domain yeroo eegumsa ifa ta'e barbaaddu.

GET
/api/emails?email=...

Imeelwwan sanduuqaa email argadhu.

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

Imeel tokko argadhu; barruu, HTML, mata dura hunda, fi metadata dabalata.

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

Imeel tokko ID irratti balleessi.

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

Imeelwwan hunda sanduuqaa keessaa haquu.

GET
/api/stats

Istaatistiksii marsarii hunda dubbisaa.

Fakkeen karaa

Gad dura lama jalqaba: tajaajila sanduuqaa uumuu, ykn prefix barbaadi. Domain ammallee beekamu beekte yoo ta'e, sanduuqaa keessatti mijeessuun gaafachuu dandeessa.

1) Teessoo email yeroo gaggaafaa random uumuu

curl 'https://mail.chatgpt.org.uk/api/generate-email' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Fakkeen deebii
{
  "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) Prefix qabatee uumuu (fakkeenya 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"}'
Fakkeen deebii
{
  "success": true,
  "data": {
    "email": "demo@example.com"
  },
  "usage": {
    "daily_limit": 200000,
    "used_today": 2,
    "remaining_today": 199998
  }
}

3) Sanduuqaa keessatti imeelwwan tarreessuu

Domain beektu yoo ta'e, tartiiba 1 darbachuun tooraan gaafachuu.

curl 'https://mail.chatgpt.org.uk/api/emails?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Fakkeen deebii
{
  "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) Imeel tokko dubbisuu — barruu, HTML, fi metadata dabalata

EMAIL_ID id tarkaanfii 3ffaa irraa deebi'een bakka buusaa. Akkasumas teessoo saanduqa galtee akka email tti dabarsaa (haquu fi dabalata buusuuf illee): achiin booda imeeliin ID'n barbaadamuu irra saanduqa isaa irraa kallattiin dubbifama. API key yoo qabaattan, paaraameetarri email dirqama miti, garuu erguun barbaacha saffisiisa.

curl 'https://mail.chatgpt.org.uk/api/email/EMAIL_ID?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Fakkeen deebii
{
  "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) Imeel tokko ID'n haquu

API key yoo qabaattan, paaraameetarri email dirqama miti, garuu erguun barbaacha saffisiisa.

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

6) Sanduuqaa hunda haquuu — teessoo kanaaf imeelwwan hunda haquu

Waamichi tokkoon tokkoon garee tokko haqa. Hamma deebiin "has_more": true qabutti, hamma false deebisutti irra deebi'ii waami.

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

Umdeebii bifa

Deebiin milkaa'ina qabu yeroo baay'ee akkana. API Key fayyadamtu yoo ta'e, usage keessatti quota ilaali.

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

Istaatistiksii bal'ina

  • /api/statistics/24h foddaa raabsa sa'aatii sa'aatii 24 tokko deebisa; foddaawwan durii argachuuf offset=1,2,... fayyadamaa.
  • /api/statistics/top-subjects mata dureewwan imeelii baay'ee mul'atan deebisa.
  • /api/statistics/top-domains deebisuu domainwwan olaanaa.
  • /api/statistics/top-senders ergaa'oota olaanaa deebisa.
GPTMail