API নথি

GPTMail API

GPTMail API ব্যবহার করে HTTPS-এর মাধ্যমে X-API-Key হেডার দিয়ে অস্থায়ী ইনবক্স তৈরি করুন, বার্তার তালিকা দেখুন ও পড়ুন এবং মেল মুছুন। এটি স্বয়ংক্রিয় পরীক্ষা, 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 পয়েন্ট। প্রতিটি ডোমেইন শুধু একটি পুরস্কার পায়। গুরুত্বপূর্ণ: সংযুক্ত হওয়ার পর সেই ডোমেইন সাফিক্স এই সাইটের সব ব্যবহারকারীর জন্য উপলব্ধ একটি পাবলিক সাফিক্সে পরিণত হয়, তাই অন্য ব্যবহারকারীরাও এর অধীনে মেইলবক্স ঠিকানা তৈরি করতে পারেন। সক্রিয় হওয়ার পর এই ডোমেইনকে আমাদের পরিষেবায় নির্দেশকারী MX রেকর্ড মুছবেন না, প্রতিস্থাপন করবেন না বা পরিবর্তন করবেন না। অন্যথায় পরবর্তী পরীক্ষায় ডোমেইনটিকে ভুলভাবে কনফিগার করা বলে গণ্য করা হতে পারে। পরবর্তী কোনো পরীক্ষায় MX রেকর্ড অবৈধ পাওয়া গেলে ডোমেইনটি নিষ্ক্রিয় করা হবে। MX রেকর্ড টানা 3টি পরীক্ষায় অবৈধ থাকলে সংশ্লিষ্ট API কী-ও নিষ্ক্রিয় করা হবে। পরে 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-এর জায়গায় উপরে দেখানো দৈনিক পাবলিক কী ব্যবহার করুন।

  • বেশিরভাগ মেলবক্স endpoint-এর জন্য email প্যারামিটার লাগে, যেমন ?email=demo@example.com।

  • GPTMail API-এর উত্তর success, data ও error ফিল্ডসহ JSON ব্যবহার করে, এবং API কী ব্যবহার করলে usage-ও থাকে। Cloudflare-এর ত্রুটি, রেট-সীমার প্রতিক্রিয়াসহ, এর বদলে HTML ফেরত দিতে পারে। JSON পার্স করার আগে HTTP স্ট্যাটাস ও Content-Type যাচাই করুন।

  • আপনি যদি সাইটের বর্তমানে সমর্থিত domain জানেন, প্রথমে email জেনারেশন endpoint কল করতে হবে না। স্থানীয়ভাবে 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=...

একটি মেলবক্সের জন্য email আনুন।

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

একটি email আনুন — টেক্সট, HTML, কাঁচা হেডার ও মেটাডাটা সহ।

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

ID দিয়ে একটি email DELETE করুন।

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

মেলবক্সের সব 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