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 ଅନୁରୋଧ, ଯାହା ସମସ୍ତ ବ୍ୟବହାରକାରୀଙ୍କ ମଧ୍ୟରେ ଅଂଶୀଦାର ହୁଏ।

ଆଜି ବାକି

ରିସେଟ୍ ହେବ

ସାର୍ବଜନୀନ କୀ ପାଇଁ ଲାଇଭ୍ କୋଟା ଲୋଡ୍ ହେଉଛି...

ତଳର 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 ରେ ଦିଆଯାଇଥିବା ସମୟ ପର୍ଯ୍ୟନ୍ତ ଅପେକ୍ଷା କରନ୍ତୁ। ଏହି ହେଡର୍ ନଥିଲେ ଅତିକମରେ 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=...

ID ଦ୍ୱାରା ଗୋଟିଏ 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) 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'
ପ୍ରତିକ୍ରିୟା ଉଦାହରଣ
{
  "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 କୀ ସହ ପ୍ରମାଣୀକରଣ କଲେ, 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