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: ඔබේම ඩොමේනය එකතු කරන්න

පොදු ඩොමේනය MX සත්‍යාපනය සමත් වූ පසු: පිවිසීමකින් තොරව ඉදිරිපත් කළේ නම් → API යතුර (ඉල්ලීම් 20000); පිවිසී ඉදිරිපත් කළේ නම් → ලකුණු 200. එක් ඩොමේනයකට එක් ත්‍යාගයක් පමණක් ලැබේ. වැදගත්: සම්බන්ධ වූ පසු එම ඩොමේන පසුල්ල මෙම අඩවියේ සියලු පරිශීලකයන්ට පොදු වේ; අන් අයද එය යටතේ තැපැල් ලිපින සාදා ගත හැක. සක්‍රිය කිරීමෙන් පසු, මෙම ඩොමේනය අපගේ සේවාවට යොමු කරන MX වාර්තාව මකන්න එපා, ප්‍රතිස්ථාපනය කරන්න එපා හෝ වෙනස් කරන්න එපා. නැතහොත් පසු විමසීම් ඩොමේනය වැරදි ලෙස සැකසූ බව සලකනු ඇත. MX වලංගු නොවේ නම් ඩොමේනය අක්‍රිය වේ. MX වාර්තාව 3 අනුක්‍රමික විමසීම් දක්වා වලංගු නොවේ නම් සම්බන්ධ API Key ද අක්‍රිය වේ. පසුව MX නැවත වලංගු නම් ඩොමේනය ස්වයංක්‍රීයව නැවත සක්‍රිය වේ.

වසම්

පොදු පරීක්ෂණ යතුර

පරීක්ෂණ සඳහා, පහත පෙන්වා ඇති හවුල් පොදු යතුර 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 පරීක්ෂා කරන්න.

  • මෙම අඩවියේ වර්තමානයේ සහාය දක්වන ඩොමේනයක් දැන සිටී නම් පළමුව email උත්පාදන අන්ත ලිපිනය අවශ්‍ය නොවේ. ඔබට දේශීයව prefix@domain සාදා සෘජුව තැපැල් පෙට්ටි APIs කැඳවිය හැක, එයින් API ඉල්ලීම් එකක් ඉතිරි වේ.

ඉල්ලීම් අනුපාත සීමා සහ නැවත උත්සාහ කිරීම්

  • GET සහ POST /api/generate-email එක් එක් මූලාශ්‍ර IP ලිපිනයක් සඳහා තත්පර 10කට ඉල්ලීම් 30ක පොදු සීමාවක් බෙදා ගනී. මෙය පොදු සහ පුද්ගලික යන දෙවර්ගයේම API යතුරු සඳහා අදාළ වේ. එකම IP පිටුපස ඇති විවිධ යතුරු සහ සේවාලාභීන් මෙම සීමාව බෙදා ගනී.

  • මෙම සීමාව ඉක්මවූ විට HTTP 429 ලැබෙන අතර තත්පර 10ක් ඊමේල් ජනනය අවහිර වේ. නැවත උත්සාහ කිරීමට පෙර Retry-After හි දක්වා ඇති කාලය රැඳී සිටින්න. මෙම header එක නොමැති නම් අවම වශයෙන් තත්පර 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=...

හැඳුනුම්පතෙන් තනි 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) හැඳුනුම්පතෙන් තනි 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