API दस्तऐवज

GPTMail API

X-API-Key हेडरसह HTTPS वरून तात्पुरते इनबॉक्स तयार करण्यासाठी, संदेशांची यादी पाहण्यासाठी व ते वाचण्यासाठी आणि मेल हटवण्यासाठी GPTMail API वापरा. हे स्वयंचलित चाचण्या, 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: स्वतःचे domain जोडा

सार्वजनिक डोमेनची MX पडताळणी यशस्वी झाल्यावर: लॉगिन न करता सादर केले → API की (20000 विनंत्या); लॉगिन करून सादर केले → 200 गुण. प्रत्येक डोमेनला फक्त एक बक्षीस मिळते. महत्त्वाचे: कनेक्ट झाल्यानंतर ते domain suffix या साइटवरील सर्व वापरकर्त्यांसाठी उपलब्ध public suffix बनते, म्हणून इतर वापरकर्ते त्याखाली mailbox पत्ते तयार करू शकतात. सक्रिय केल्यानंतर, आमच्या सेवेकडे या domain ला निर्देशित करणारा MX रेकॉर्ड हटवू नका, बदलू नका किंवा सुधरू नका. अन्यथा नंतरच्या तपासण्या domain चुकीचे कॉन्फिगर केले असे मानू शकतात. MX रेकॉर्ड अवैध असल्यास domain निष्क्रिय केले जाईल. MX रेकॉर्ड 3 सलग तपासण्यांमध्ये अवैध राहिल्यास संबंधित API Key देखील निष्क्रिय केले जाईल. MX रेकॉर्ड नंतर पुन्हा वैध झाल्यास domain आपोआप पुन्हा सक्रिय होईल.

डोमेन्स

सार्वजनिक चाचणी की

चाचणीसाठी, खाली दाखवलेली सामायिक सार्वजनिक की X-API-Key हेडरमध्ये पाठवा. ती दररोज बदलते आणि तिची दैनिक मर्यादा 200,000 विनंत्यांची आहे, जी सर्व वापरकर्त्यांमध्ये सामायिक असते.

आज उर्वरित

रीसेट होईल

public key साठी live quota लोड करत आहे...

खालील API संदर्भ AI साधने, ज्ञानकोश किंवा README साठी Markdown म्हणून कॉपी करता येतो.

बेस यूआरएल: https://mail.chatgpt.org.uk

AI
llms.txt

·

llms-full.txt

(Markdown)

द्रुत सुरुवात

  • X-API-Key: YOUR_KEY हा सर्वात सोपा पर्याय आहे. जलद चाचण्यांसाठी YOUR_KEY ऐवजी वर दाखवलेली दैनिक सार्वजनिक की वापरा.

  • बहुतेक mailbox endpoints ला email पॅरामीटर लागतो, उदा. ?email=demo@example.com.

  • GPTMail API प्रतिसाद success, data आणि error फील्ड असलेले JSON वापरतात, आणि API की वापरल्यास usage देखील असते. विनंती दर मर्यादेच्या प्रतिसादांसह Cloudflare त्रुटी त्याऐवजी HTML परत करू शकतात. JSON पार्स करण्यापूर्वी HTTP स्थिती आणि Content-Type तपासा.

  • या साइटवरील सध्या समर्थित domain तुम्हाला माहीत असल्यास प्रथम email generation endpoint कॉल करणे आवश्यक नाही. तुम्ही स्थानिक पातळीवर prefix@domain बनवून mailbox APIs थेट कॉल करू शकता, एक API विनंती वाचते.

विनंती दर मर्यादा आणि पुन्हा प्रयत्न

  • GET आणि POST /api/generate-email प्रत्येक स्रोत IP साठी 10 सेकंदांत 30 विनंत्यांची सामायिक मर्यादा वापरतात. हे सार्वजनिक आणि वैयक्तिक दोन्ही API कींना लागू होते. एकाच IP मागील वेगवेगळ्या की आणि क्लायंट ही मर्यादा सामायिक करतात.

  • ही मर्यादा ओलांडल्यास HTTP 429 परत येतो आणि 10 सेकंदांसाठी ईमेल तयार करणे अवरोधित होते. पुन्हा प्रयत्न करण्यापूर्वी Retry-After मध्ये दिलेल्या कालावधीपर्यंत थांबा. हा हेडर नसल्यास, किमान 10 सेकंद थांबा आणि नंतर वाढत्या अंतराने पुन्हा प्रयत्न करा. एकच IP वापरणाऱ्या क्लायंटनी एकाच वेळी पुन्हा प्रयत्न करणे टाळा.

  • हा नियम इनबॉक्स यादी पाहणे किंवा एकेक ईमेल वाचणे यांना लागू होत नाही. API कीचे दैनिक आणि एकूण कोटा तरीही स्वतंत्रपणे लागू होतात. 10 सेकंद थांबल्याने संपलेला की कोटा परत मिळत नाही.

मुख्य Endpoints

POST / GET
/api/generate-email

तात्पुरती inbox तयार करा. सर्वात सोप्या random inbox प्रवाहासाठी GET वापरा, किंवा स्पष्ट नियंत्रण हवे असल्यास prefix आणि domain सह POST वापरा.

GET
/api/emails?email=...

एका mailbox साठी email आणा.

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

एक email आणा — मजकूर, HTML, raw headers आणि metadata सह.

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

ID नुसार एक email हटवा.

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

एका mailbox मधील सर्व email हटवा.

GET
/api/stats

संपूर्ण साइटवरील आकडेवारी वाचा.

उदाहरण प्रवाह

खाली दोन सामान्य नमुने आहेत: सेवेला inbox तयार करू द्या, किंवा निश्चित prefix विनंती करा. सध्या समर्थित domain तुम्हाला माहीत असल्यास तुम्ही स्थानिक पातळीवर mailbox बनवून थेट चौकशी करू शकता.

1) यादृच्छिक तात्पुरती email पत्ता तयार करा

curl 'https://mail.chatgpt.org.uk/api/generate-email' \
  -H 'X-API-Key: PUBLIC_API_KEY'
response उदाहरण
{
  "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"}'
response उदाहरण
{
  "success": true,
  "data": {
    "email": "demo@example.com"
  },
  "usage": {
    "daily_limit": 200000,
    "used_today": 2,
    "remaining_today": 199998
  }
}

3) inbox मधील email यादी

समर्थित domain माहीत असल्यास पायरी 1 वगळून थेट चौकशी करा.

curl 'https://mail.chatgpt.org.uk/api/emails?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
response उदाहरण
{
  "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) एक ईमेल वाचा — त्यात साधा मजकूर, 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'
response उदाहरण
{
  "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'
response उदाहरण
{
  "success": true,
  "data": {
    "message": "Email deleted"
  }
}

6) संपूर्ण inbox साफ करा — या पत्त्यासाठी सर्व 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'
response उदाहरण
{
  "success": true,
  "data": {
    "message": "Deleted 3 emails",
    "count": 3,
    "has_more": false
  }
}

Response आकार

यशस्वी responses सामान्यतः असे दिसतात. API Key ने प्रमाणीकरण केल्यास usage मधील quota माहती लक्षात घ्या.

{
  "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 सर्वात सक्रिय domain परत करते.
  • /api/statistics/top-senders सर्वात सक्रिय प्रेषक परत करते.
GPTMail