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 ആയി പകർത്താം.

ബേസ് 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 പ്രതികരണങ്ങൾ success, data, error ഫീൽഡുകളുള്ള JSON ഉപയോഗിക്കുന്നു; 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=...

ടെക്സ്റ്റ്, HTML, യഥാർത്ഥ ഹെഡറുകൾ, മെറ്റാഡാറ്റ എന്നിവ ഉൾപ്പെടെ ഒരു ഇമെയിൽ എടുക്കുക.

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