Imibhalo ye-API

I-GPTMail API

Sebenzisa i-API ye-GPTMail ukuze udale amabhokisi okungenayo esikhashana, ubone uhlu futhi ufunde imilayezo, futhi ususe ama-imeyili nge-HTTPS usebenzisa i-header ye-X-API-Key. Ilungele ukuhlola okuzenzakalelayo, amapayipi e-CI/CD, nokugeleza komsebenzi kwe-QA.

Indlela yokuthola i-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

Inketho 2: Engeza idomain yakho

Ngemva kokuba idomain yomphakathi iphumelele ukuqinisekiswa kwe-MX: ithunyelwe ungangenile → ukhiye we-API (izicelo ezingu-20000); ithunyelwe ungene ngemvume → amaphuzu angu-200. Idomain ngayinye ithola umvuzo owodwa kuphela. Kubalulekile: uma isixhumanisi, isuffix sedomain iba isuffix yomphakathi kubo bonke abasebenzisi, ngakho abasebenzisi abanye bangakwazi ukudala izikhethi zebhokisi ngaphansi kwayo. Ngemva kokusebenza, ungakwazi ukususa, ukushintsha, noma ukulungisa irekhodi ye-MX ekhombisa idomain esebenzisini wethu. Ngaphandle kwalokho, ukubuyekezwa okulandelayo kungabona idomain ingahleleki kahle. Uma ukubuyekezwa kubona i-MX engavumelekile, idomain izocishwa. Uma i-MX iqhubeka ingavumelekile ezibuyekezweni ezingama-3 ezilandelelanayo, ne-API Key ehlobene izocishwa futhi. Uma i-MX ibuya ivumelekile kamuva, idomain izokwenziwa isebenze kabusha ngokuzenzakalelayo.

Izizinda

Ukhiye womphakathi wokuhlola

Ukuze uhlole, thumela ukhiye womphakathi owabelwanayo oboniswe ngezansi ku-header ye-X-API-Key. Uyashintsha nsuku zonke futhi unomkhawulo wansuku zonke wezicelo eziyi-200,000 owabelwana ngabo bonke abasebenzisi.

Kusele namuhla

Isetha kabusha ku

Iyalayisha i-quota ebukhoma ngesihluthulelo somphakathi...

Isalathiso se-API ngezansi singakopishwa njenge-Markdown amathuluzi e-AI, izisekelo zolwazi, noma i-README.

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

AI
llms.txt

·

llms-full.txt

(Markdown)

Ukuqala ngokushesha

  • X-API-Key: YOUR_KEY iyindlela elula kakhulu. Ekuhloleni okusheshayo, sebenzisa ukhiye womphakathi wansuku zonke oboniswe ngenhla esikhundleni se-YOUR_KEY.

  • Iningi lezixhumanisi zebhokisi liyadinga ipharamitha email, isibonelo ?email=demo@example.com.

  • Izimpendulo ze-API ye-GPTMail zisebenzisa i-JSON enezinkambu ze-success, data ne-error, kanye ne-usage uma kusetshenziswa ukhiye we-API. Amaphutha e-Cloudflare, kuhlanganise nezimpendulo zomkhawulo wezicelo, angabuyisela i-HTML. Hlola isimo se-HTTP ne-Content-Type ngaphambi kokuhlaziya i-JSON.

  • Uma useseyazi idomain esekelwayo okwamanje kule sayithi, awudingi ukubiza kuqala isixhumanisi sokukhiqiza i-imeyili. Ungakwazi ukwakha prefix@domain endaweni bese ubiza ngqo ama-API ebhokisi, okulondoloza isicelo se-API esisodwa.

Imikhawulo yezicelo nokuzama futhi

  • GET ne-POST /api/generate-email zabelana ngomkhawulo wezicelo ezingama-30 njalo ngemizuzwana eyi-10 nge-IP ngayinye yomthombo. Lokhu kusebenza kokubili kokhiye be-API bomphakathi nabomuntu siqu. Okhiye namaklayenti ahlukene asebenzisa i-IP efanayo abelana ngalo mkhawulo.

  • Ukweqa lo mkhawulo kubuyisela i-HTTP 429 futhi kuvimba ukwakhiwa kwamakheli e-imeyili imizuzwana eyi-10. Linda isikhathi esishiwo yi-Retry-After ngaphambi kokuzama futhi. Uma lesi sihloko singekho, linda okungenani imizuzwana eyi-10, bese uzama futhi wandise isikhathi sokulinda. Gwema ukuzama futhi ngesikhathi esifanayo kumaklayenti abelana nge-IP.

  • Lo mthetho awusebenzi ekuboniseni uhlu lwemiyalezo ebhokisini lokungenayo noma ekufundeni i-imeyili ngayinye. Imikhawulo yansuku zonke neyonke yokhiye be-API isasebenza ngokuzimela. Ukulinda imizuzwana eyi-10 akubuyiseli isabelo sokhiye esiphelile.

Izixhumanisi eziyinhloko

POST / GET
/api/generate-email

Dala ibhokisi le-imeyili esikhashana. Sebenzisa GET ukuze uhamba olula lwebhokisi elingenanto, noma POST kanye ne-prefix ne-domain uma ufuna ukulawula okucacile.

GET
/api/emails?email=...

Thola ama-imeyili ebhokisi le-imeyili.

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

Thola i-imeyili elilodwa, kufaka umbhalo, i-HTML, izihloko ezingaphephisi, nemetadata.

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

Susa i-imeyili elilodwa nge-ID.

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

Susa zonke ama-imeyili ebhokisi le-imeyili.

GET
/api/stats

Funda izibalo zesayithi yonke.

Isibonelo somgwaqo

Ngezansi kukhona izindlela ezimbili ezivamile: vumela isevisi yenze ibhokisi, noma cela i-prefix ebekiwe. Uma useseyazi idomain esekelwayo okwamanje, ungakwazi futhi ukwakha ibhokisi endaweni bese ubuza ngqo.

1) Dala ikheli le-imeyili lesikhashana elingenanto

curl 'https://mail.chatgpt.org.uk/api/generate-email' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Isibonelo sompendulo
{
  "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) Dala nge-prefix ebekiwe (isb. 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"}'
Isibonelo sompendulo
{
  "success": true,
  "data": {
    "email": "demo@example.com"
  },
  "usage": {
    "daily_limit": 200000,
    "used_today": 2,
    "remaining_today": 199998
  }
}

3) Uhlu lama-imeyili ebhokisi

Uma useseyazi idomain esekelwayo, weqa isinyathelo 1 bese ubuza ngqo.

curl 'https://mail.chatgpt.org.uk/api/emails?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Isibonelo sompendulo
{
  "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) Funda i-imeyili eyodwa — kufaka umbhalo ovulekile, umzimba we-HTML, nemetadata

Faka i-id ebuyiswe esinyathelweni 3 esikhundleni se-EMAIL_ID. Dlulisa nekheli lebhokisi lokungenayo njenge-email (nalapho ususa noma ulanda okunamathiselwe): bese i-imeyili ifundwa ngqo ebhokisini layo esikhundleni sokuthi iseshwe nge-ID. Ngokhiye we-API, ipharamitha email ayiphoqelekile, kodwa ukuyithumela kwenza ukusesha kushesha.

curl 'https://mail.chatgpt.org.uk/api/email/EMAIL_ID?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Isibonelo sompendulo
{
  "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) Susa i-imeyili eyodwa nge-ID

Ngokhiye we-API, ipharamitha email ayiphoqelekile, kodwa ukuyithumela kwenza ukusesha kushesha.

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

6) Geza ibhokisi lonke — susa zonke ama-imeyili kuleli kheli

Ucingo ngalunye lususa iqoqo elilodwa. Inqobo nje uma impendulo inokuthi "has_more": true, phinda uyibize kuze kubuyiswe false.

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

Isimo sompendulo

Impendulo eziphumelelayo zivame ukubukeka kanje. Uma uqinisekisa nge-API Key, qaphela ulwazi lwe-quota ngaphakathi kwe-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
  }
}

Izibalo ezandisiwe

  • /api/statistics/24h ibuyisa iwindi elilodwa lokusabalala ngehora lamahora angu-24; sebenzisa offset=1,2,... kumawindi amadala.
  • /api/statistics/top-subjects ibuyisela izihloko ze-imeyili ezivame kakhulu.
  • /api/statistics/top-domains ibuyisela izizinda ezisebenza kakhulu.
  • /api/statistics/top-senders ibuyisela abathumeli abasebenza kakhulu.
GPTMail