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 উত্তৰসমূহ JSON ব্যৱহাৰ কৰে success সৈতে, data, error, আৰু usage ক্ষেত্ৰসমূহৰ সৈতে, আৰু যেতিয়া API কি ব্যৱহাৰ কৰা হয়। Cloudflare ভুল, গতি-সীমাৰ উত্তৰসমূহৰ অন্তৰ্ভুক্ত, HTML ঘূৰাই দিব পাৰে। HTTP অৱস্থা আৰু Content-Type পৰীক্ষা কৰক JSON বিশ্লেষণ কৰাৰ আগতে।

  • যদি আপুনি এই ছাইটত বৰ্তমান সমৰ্থিত ডমেইন জানে, প্ৰথমে 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