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: ನಿಮ್ಮ ಸ್ವಂತ 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 ಉಲ್ಲೇಖವನ್ನು Markdown ಆಗಿ ನಕಲಿಸಬಹುದು — AI ಉಪಕರಣಗಳು, ಜ್ಞಾನಾಧಾರಗಳು ಅಥವಾ README ಗಾಗಿ.

ಬೇಸ್ URL: 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 ಪ್ರತಿಕ್ರಿಯೆಗಳು JSON ಬಳಸುತ್ತವೆ ಮತ್ತು success, data, error ಕ್ಷೇತ್ರಗಳನ್ನು ಹೊಂದಿರುತ್ತವೆ. API ಕೀ ಬಳಸಿದಾಗ usage ಕೂಡ ಇರುತ್ತದೆ. ವಿನಂತಿ ಮಿತಿಯ ಪ್ರತಿಕ್ರಿಯೆಗಳು ಸೇರಿದಂತೆ Cloudflare ದೋಷಗಳು HTML ನೀಡಬಹುದು. JSON ಪಾರ್ಸ್ ಮಾಡುವ ಮೊದಲು HTTP ಸ್ಥಿತಿ ಮತ್ತು Content-Type ಪರಿಶೀಲಿಸಿ.

  • ಈ ಸೈಟ್ ನಲ್ಲಿ ಪ್ರಸ್ತುತ ಬೆಂಬಲಿತ domain ನಿಮಗೆ ಈಗಾಗಲೇ ತಿಳಿದಿದ್ದರೆ, ಮೊದಲು email generation endpoint ಅನ್ನು ಕರೆಯಬೇಕಾಗಿಲ್ಲ. ನೀವು locally prefix@domain ರಚಿಸಿ mailbox API ಗಳನ್ನು ನೇರವಾಗಿ ಕರೆಯಬಹುದು, ಒಂದು 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 ನಿಮಗೆ ಈಗಾಗಲೇ ತಿಳಿದಿದ್ದರೆ, ನೀವು locally mailbox ರಚಿಸಿ ನೇರವಾಗಿ query ಮಾಡಬಹುದು.

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 ಬಿಟ್ಟು ನೇರವಾಗಿ query ಮಾಡಿ.

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