API ھۆججەتلىرى

GPTMail API

GPTMail API ئارقىلىق X-API-Key باش ئۇچۇرى بىلەن HTTPS ئۈستىدە ۋاقىتلىق خەت ساندۇقى ھاسىل قىلىش، خەتلەرنى تىزىش ۋە ئوقۇش، شۇنداقلا ئېلخەتلەرنى ئۆچۈرۈشكە بولىدۇ. ئۇ ئاپتوماتىك سىناق، CI/CD لىنىيىسى ۋە QA ئىش ئېقىمىغا ماس كېلىدۇ.

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

تاللاش 2: ئۆز دائىرە نامىڭىزنى قوشۇڭ

ئاممىۋى دائىرە نامى MX تەكشۈرۈشىدىن ئۆتكەندە: تىزىمغا كىرمەي يوللانغان بولسا → API ئاچقۇچى (20000 تەلەپ)؛ تىزىمغا كىرىپ يوللانغان بولسا → 200 نومۇر. ھەر دائىرە نامى پەقەت بىر مۇكاپات ئالىدۇ. مۇھىم: ئۇلانغاندىن كېيىن ئۇ دائىرە قوشۇمچىسى بۇ تور بېكەتتىكى بارلىق ئابونتلارغا ئاشكارا بولىدۇ، باشقىلارمۇ ئۇنىڭ ئاستىدا خەت ساندۇقى ئادرېسى ھاسىل قىلالايدۇ. قوزغاتقاندىن كېيىن، بۇ دائىرە نامىنى مۇلازىمىتىمىزگە يۆنەلتكەن MX خاتىرىسىنى ئۆچۈرمەڭ، ئالماشتۇرماڭ ياكى ئۆزگەرتمەڭ. بولمىسا كېيىنكى تەكشۈرۈشلەر دائىرە نامىنى خاتا سەپلەنگەن دەپ قارىشى مۇمكىن. MX ئىناۋەتسىز بولسا دائىرە نامى توختىتىلىدۇ. MX ئۇدا 3 قېتىم تەكشۈرۈشتە ئىناۋەتسىز بولسا مۇناسىۋەتلىك API Key مۇ توختىتىلىدۇ. كېيىن MX قايتا ئىناۋەتلىك بولسا دائىرە نامى ئاپتوماتىك قايتا قوزغىتىلىدۇ.

دائىرىلەر

ئاممىۋى سىناق ئاچقۇچى

سىناق ئۈچۈن تۆۋەندە كۆرسىتىلگەن ئورتاق ئاممىۋى ئاچقۇچنى X-API-Key باش ئۇچۇرىدا ئەۋەتىڭ. ئۇ ھەر كۈنى ئۆزگىرىدۇ ۋە بارلىق ئىشلەتكۈچىلەر ئورتاق ئىشلىتىدىغان كۈندىلىك 200,000 قېتىملىق تەلەپ چېكى بار.

بۈگۈن قالغان

قايتا بەلگىلەش

ئاممىۋى key نىڭ ھازىرقى چېكى يۈكلەۋاتىدۇ...

تۆۋەندىكى API پايدىلىنىشى AI قوراللىرى، بىلىم ئامبىرى ياكى README ئۈچۈن Markdown قىلىپ كۆچۈرۈشكە بولىدۇ.

ئاساسىي ئادرېس: https://mail.chatgpt.org.uk

AI
llms.txt

·

llms-full.txt

(Markdown)

تېز باشلاش

  • X-API-Key: YOUR_KEY ئەڭ ئاددىي ئۇسۇل. تېز سىناق ئۈچۈن YOUR_KEY نىڭ ئورنىغا يۇقىرىدا كۆرسىتىلگەن كۈندىلىك ئاممىۋى ئاچقۇچنى ئىشلىتىڭ.

  • كۆپ قىسىم خەت ساندۇقى ئۇلانما نۇقتىلىرى email پارامېتىرى تەلەپ قىلىدۇ، مەسىلەن ?email=demo@example.com.

  • GPTMail API جاۋابلىرى success، data ۋە error ساھەلىرى بار JSON نى ئىشلىتىدۇ، API ئاچقۇچى ئىشلىتىلگەندە usage مۇ بولىدۇ. Cloudflare خاتالىقلىرى، جۈملىدىن سۈرئەت چېكى جاۋابلىرى، ئۇنىڭ ئورنىغا HTML قايتۇرۇشى مۇمكىن. JSON نى تەھلىل قىلىشتىن بۇرۇن HTTP ھالىتى ۋە Content-Type نى تەكشۈرۈڭ.

  • ئەگەر بۇ تور بېكەتتىكى نۆۋەتتە قوللىنىدىغان دائىرە نامىنى بىلسىڭىز، ئالدى بىلەن email ھاسىل قىلىش ئۇلانما نۇقتىسىنى چاقىرىشىڭىز ھاجەتسىز. يەرلىكتە prefix@domain تۈزۈپ بىۋاسىتە خەت ساندۇقى API لىرىنى چاقىرسىڭىز بولىدۇ، بۇ بىر قېتىم API تەلىپىنى تېجەيدۇ.

سۈرئەت چېكى ۋە قايتا سىناش

  • GET ۋە POST /api/generate-email ھەر بىر مەنبە IP ئۈچۈن ھەر 10 سېكۇنتتا 30 تەلەپتىن ئىبارەت ئورتاق چەكنى ئىشلىتىدۇ. بۇ ئاممىۋى ۋە شەخسىي API ئاچقۇچلىرىنىڭ ھەممىسىگە ماس كېلىدۇ. ئوخشاش IP ئارقىسىدىكى ئوخشىمىغان ئاچقۇچلار ۋە خېرىدار پروگراممىلار بۇ چەكنى ئورتاق ئىشلىتىدۇ.

  • بۇ چەكتىن ئېشىپ كەتسە HTTP 429 قايتۇرۇلىدۇ ۋە ئېلخەت ھاسىل قىلىش 10 سېكۇنت توسۇلىدۇ. قايتا سىناشتىن بۇرۇن Retry-After دا كۆرسىتىلگەن ۋاقىتنى كۈتۈڭ. بۇ باش ئۇچۇرى بولمىسا، كەم دېگەندە 10 سېكۇنت كۈتۈپ، ئاندىن ئارىلىقنى بارغانسېرى ئۇزارتىپ قايتا سىناڭ. ئوخشاش IP نى ئورتاق ئىشلىتىدىغان خېرىدار پروگراممىلارنىڭ بىرلا ۋاقىتتا قايتا سىنىشىدىن ساقلىنىڭ.

  • بۇ قائىدە خەت ساندۇقى تىزىملىكى ياكى ئايرىم ئېلخەتلەرنى ئوقۇشقا ماس كەلمەيدۇ. API ئاچقۇچلىرىنىڭ كۈندىلىك ۋە ئومۇمىي نورمىسى يەنىلا ئايرىم كۈچكە ئىگە. 10 سېكۇنت كۈتۈش تۈگىگەن ئاچقۇچ نورمىسىنى ئەسلىگە كەلتۈرمەيدۇ.

ئاساسىي ئۇلانما نۇقتىلىرى

POST / GET
/api/generate-email

ۋاقىتلىق خەت ساندۇقى ھاسىل قىلىڭ. ئەڭ ئاددىي ئىختىيارىي ئېقىم ئۈچۈن GET ئىشلىتىڭ، ياكى ئېنىق كونترول ئۈچۈن prefix ۋە domain بىلەن POST ئىشلىتىڭ.

GET
/api/emails?email=...

بىر خەت ساندۇقى ئۈچۈن email ئېلىڭ.

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

بىر email ئېلىڭ — تېكىست، HTML، خام باشلىق ۋە مېتا سانلىق مەلۇمات بىلەن.

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

ID ئارقىلىق بىر email ئۆچۈرۈڭ.

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

بىر خەت ساندۇقىدىكى بارلىق email لارنى ئۆچۈرۈڭ.

GET
/api/stats

پۈتۈن تور بېكەت ئىستاتىستىكىسىنى ئوقۇڭ.

مىسال ئېقىمى

تۆۋەندە ئىككى ئادەتتىكى ئۇسۇل بار: مۇلازىمەتنىڭ سىز ئۈچۈن خەت ساندۇقى ھاسىل قىلىشىغا يول قويۇڭ، ياكى بېكىتىلگەن prefix تەلەپ قىلىڭ. ئەگەر نۆۋەتتە قوللىنىدىغان دائىرە نامىنى بىلسىڭىز، يەرلىكتە prefix@domain تۈزۈپ بىۋاسىتە سورىسىڭىز بولىدۇ.

1) ئىختىيارىي ۋاقىتلىق email ئادرېسى ھاسىل قىلىڭ

curl 'https://mail.chatgpt.org.uk/api/generate-email' \
  -H 'X-API-Key: PUBLIC_API_KEY'
جاۋاب مىسالى
{
  "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 بىلەن ھاسىل قىلىڭ (مەسىلەن 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"}'
جاۋاب مىسالى
{
  "success": true,
  "data": {
    "email": "demo@example.com"
  },
  "usage": {
    "daily_limit": 200000,
    "used_today": 2,
    "remaining_today": 199998
  }
}

3) خەت ساندۇقىدىكى email لارنى تىزىڭ

قوللىنىدىغان دائىرە نامىنى بىلسىڭىز 1-قەدەمنى ئاتلاپ بىۋاسىتە سورىسىڭىز بولىدۇ.

curl 'https://mail.chatgpt.org.uk/api/emails?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
جاۋاب مىسالى
{
  "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) بىر email ئوقۇڭ — ساددا تېكىست، HTML گەۋدىسى ۋە مېتا سانلىق مەلۇمات بىلەن

EMAIL_ID نى 3-قەدەمدە قايتۇرۇلغان id بىلەن ئالماشتۇرۇڭ. خەت ساندۇقى ئادرېسىنىمۇ email سۈپىتىدە يەتكۈزۈڭ (ئۆچۈرۈش ۋە قوشۇمچە ھۆججەت چۈشۈرۈشتىمۇ): شۇنداق قىلسا ئېلخەت ID بويىچە ئىزدەلمەي، بىۋاسىتە ئۆز خەت ساندۇقىدىن ئوقۇلىدۇ. API ئاچقۇچى بولسا email پارامېتىرى ئىختىيارىي، ئەمما ئۇنى يوللىسىڭىز ئىزدەش تېزلىشىدۇ.

curl 'https://mail.chatgpt.org.uk/api/email/EMAIL_ID?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
جاۋاب مىسالى
{
  "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 ئارقىلىق بىر email ئۆچۈرۈڭ

API ئاچقۇچى بولسا email پارامېتىرى ئىختىيارىي، ئەمما ئۇنى يوللىسىڭىز ئىزدەش تېزلىشىدۇ.

curl -X DELETE 'https://mail.chatgpt.org.uk/api/email/EMAIL_ID?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
جاۋاب مىسالى
{
  "success": true,
  "data": {
    "message": "Email deleted"
  }
}

6) پۈتۈن خەت ساندۇقىنى تازىلاڭ — بۇ ئادرېسنىڭ بارلىق email لىرىنى ئۆچۈرىدۇ

ھەر قېتىملىق چاقىرىش بىر تۈركۈمنى ئۆچۈرىدۇ. جاۋابتا "has_more": true بولسىلا، false قايتۇرغۇچە قايتا چاقىرىڭ.

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

جاۋاب شەكلى

مۇۋەپپەقىيەتلىك جاۋابلار ئادەتتە مۇشۇنداق. API key بىلەن دەلىللىگەندە 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
  }
}

كېڭەيتىلگەن ئىستاتىستىكا

  • /api/statistics/24h 24 سائەتلىك سائەتلىك تارقىلىش كۆزنىكىدىن بىرنى قايتۇرىدۇ؛ ئىلگىرىكى كۆزنەكلەر ئۈچۈن offset=1,2,... نى ئىشلىتىڭ.
  • /api/statistics/top-subjects ئەڭ كۆپ ئۇچرايدىغان ئېلخەت تېمىلىرىنى قايتۇرىدۇ.
  • /api/statistics/top-domains ئەڭ ئاكتىپ دائىرە ناملىرىنى قايتۇرىدۇ.
  • /api/statistics/top-senders ئەڭ ئاكتىپ ئەۋەتكۈچىلەرنى قايتۇرىدۇ.
GPTMail