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 அனைத்து பயனர்களுக்கும் பொதுவான suffix ஆகிறது; எனவே மற்றவர்களும் அதன் கீழ் மின்னஞ்சல் முகவரிகளை உருவாக்க முடியும். செயல்படுத்திய பின், எங்கள் சேவைக்கு domain ஐ சுட்டும் MX பதிவை நீக்காதீர்கள், மாற்றாதீர்கள், மாற்றிவிடாதீர்கள்; இல்லையெனில் பின்னர் சரிபார்ப்புகள் domain தவறாக உள்ளமைக்கப்பட்டது எனக் கருதலாம். பின்னர் MX செல்லாததாகக் கண்டறிந்தால் domain செயலிழக்கச் செய்யப்படும். 3 தொடர்ச்சியான சரிபார்ப்புகளில் MX செல்லுபடியாகாமல் இருந்தால், தொடர்புடைய API key யும் செயலிழக்கச் செய்யப்படும். பின்னர் MX மீண்டும் செல்லுபடியானால், domain தானாக மீண்டும் செயல்படுத்தப்படும்.

டொமைன்கள்

பொது சோதனை விசை

சோதனைக்கு, கீழே காட்டப்படும் பகிரப்பட்ட பொது விசையை X-API-Key தலைப்பில் அனுப்புங்கள். இது ஒவ்வொரு நாளும் மாறும்; அனைத்துப் பயனர்களும் பகிர்ந்துகொள்ளும் தினசரி வரம்பு 200,000 கோரிக்கைகள்.

இன்று மீதம்

மீட்டமைகிறது

பொது key க்கான நேரடி ஒதுக்கீடு ஏற்றுகிறது...

கீழுள்ள API குறிப்பை AI கருவிகள், அறிவுத் தளங்கள் அல்லது README க்காக Markdown ஆக நகலெடுக்கலாம்.

அடிப்படை URL: 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-ஐயும் சரிபார்க்கவும்.

  • தளத்தில் ஆதரவுள்ள domain தெரியுமெனில் முதலில் email உருவாக்க முனையை அழைக்க வேண்டியதில்லை. prefix@domain ஐ உள்ளூராக கட்டி மெயில்பாக்ஸ் 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

தற்காலிக இன்பாக்ஸை உருவாக்கவும். மிக எளிய சீரற்ற இன்பாக்ஸ் ஓட்டத்திற்கு GET பயன்படுத்தவும்; தெளிவான கட்டுப்பாடு வேண்டுமெனில் prefix மற்றும் domain உடன் POST.

GET
/api/emails?email=...

ஒரு மெயில்பாக்ஸின் மின்னஞ்சல்களைப் பெறவும்.

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

ஒரு மின்னஞ்சலைப் பெறவும் — உரை, HTML, மூலத் தலைப்புகள் மற்றும் மெட்டாடேட்டா உட்பட.

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

ID மூலம் ஒரு மின்னஞ்சலை DELETE செய்யவும்.

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

மெயில்பாக்ஸில் உள்ள அனைத்து மின்னஞ்சல்களையும் DELETE செய்யவும்.

GET
/api/stats

தள அளவிலான புள்ளிவிவரங்களைப் படிக்கவும்.

எடுத்துக்காட்டு ஓட்டம்

பொதுவான இரண்டு பாணிகள்: சேவையை உங்களுக்காக இன்பாக்ஸ் உருவாக்க விடுங்கள் அல்லது நிலையான prefix கேளுங்கள். ஏற்கனவே ஆதரவுள்ள domain தெரியுமெனில், மெயில்பாக்ஸை உள்ளூராக கட்டமைத்து நேரடியாக query செய்யலாம்.

1) சீரற்ற தற்காலிக மின்னஞ்சல் முகவரியை உருவாக்கு

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) இன்பாக்ஸில் மின்னஞ்சல்களை பட்டியலிடு

ஆதரவுள்ள domain தெரிந்தால் படி 1 ஐத் தவிர்த்து நேரடியாக query செய்யவும்.

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) ஒரு மின்னஞ்சலைப் படி — சாதாரண உரை, 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 மூலம் ஒரு மின்னஞ்சலை DELETE செய்

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) முழு இன்பாக்ஸை அழி — இந்த முகவரிக்கான அனைத்து மின்னஞ்சல்களையும் நீக்கும்

ஒவ்வொரு அழைப்பும் ஒரு தொகுதியை நீக்கும். பதிலில் "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 மிகவும் செயலில் உள்ள domains களைத் தருகிறது.
  • /api/statistics/top-senders மிகவும் செயலில் உள்ள senders களைத் தருகிறது.
GPTMail