১৪. টেম্পমেইলগ এপিআই ডকুমেন্টেশন

REST API v1 & ওয়েবহুকস

TempMailg ডেভেলপার API ডকস

১৫. এই ডকুমেন্টেশনটি ব্যবহার করুন আপনার ব্যক্তিগত API কী তৈরি করতে, ডেডিকেটেড ব্যবহারকারী API হোস্ট সংযোগ করতে, মেইলবক্স বার্তা পড়তে, মালিকানাধীন মেইলবক্স পরিচালনা করতে এবং টেম্প মেইলকে আপনার নিজস্ব অ্যাপস বা অটোমেশনে একীভূত করতে।

বেয়ারার টোকেন প্রমাণীকরণ রিয়েল-টাইম ওয়েবহুকস জিমেইল & আউটলুক উপনাম JSON প্রতিক্রিয়া
৯. ব্যবহারকারী এপিআই বেস ইউআরএল HTTPS
১৬. অনুরোধের ফরম্যাট ১৭. শুধুমাত্র অথেনটিকেশন বিয়ারার হেডারে আপনার API কী ব্যবহার করুন এবং এন্ডপয়েন্ট ইউআরএল পরিষ্কার রাখুন।

মেইলবক্স ব্যবস্থাপনা

অনুমোদিত ডোমেইনগুলি আনুন, মেলবক্স তৈরি বা পরিবর্তন করুন, অনুমোদিত জীবদ্দশা নির্বাচন করুন, এবং মালিকানাধীন ঠিকানাগুলি মুছে ফেলুন।

GET https://v1.tempmailg.com/api/domains?type={type}
#

অনুমোদিত ডোমেইনগুলির তালিকা

অস্থায়ী ইমেইল তৈরি করার জন্য উপলব্ধ ডোমেইনগুলির তালিকা দেখুন। আপনার সাবস্ক্রিপশন পরিকল্পনা দ্বারা সমর্থিত শুধুমাত্র ফ্রি, প্রিমিয়াম, অথবা কাস্টম ডোমেইন দেখতে টাইপ অনুযায়ী ফিল্টার করুন।

প্যারামিটার 1
প্যারামিটার অবস্থান ১৩. ধরন স্থিতি ২২. বিবরণ
type query string ঐচ্ছিক
ডোমেইন স্তর ফিল্টার। বাদ দিলে সব ব্যবহার হয় যখন প্রিমিয়াম-ডোমেইন অ্যাক্সেস সক্রিয় থাকে, অন্যথায় ফ্রি। স্বীকৃত মানগুলি: free, basic, pro, premium, custom, ultimate, all
ডিফল্ট: অ্যাকাউন্ট-নির্ভরশীল
১৩. অনুমোদিত ডোমেইন পান
curl --request GET \
  --url 'https://v1.tempmailg.com/api/domains?type=free' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

সিন্থেটিক ডেটা ব্যবহার করে উদাহরণস্বরূপ প্রতিক্রিয়া। আইডি, ঠিকানা, টোকেন, টাইমস্ট্যাম্প, পরিকল্পনা সীমা এবং গণনা পরিবর্তিত হয়। নমুনা লাইফটাইম আপনার পরিকল্পনার ডিফল্টকে অতিক্রম করে না। প্রতিক্রিয়া ফিল্ডের বিবরণ nullable এবং প্রদানকারী-নির্দিষ্ট ফিল্ডগুলি চিহ্নিত করে।

১৪. উদাহরণ প্রতিক্রিয়া
200 OK • JSON
{
    "status": true,
    "data": {
        "requested_type": "free",
        "plan": "pro",
        "plan_name": "Pro Plan",
        "allowed_types": [
            "free",
            "basic",
            "pro",
            "premium",
            "custom",
            "ultimate",
            "all"
        ],
        "domains": [
            {
                "domain": "example.com",
                "type": "Free",
                "custom": false
            }
        ]
    }
}
প্রতিক্রিয়া ক্ষেত্রসমূহ
ক্ষেত্র ১৩. ধরন ২২. বিবরণ
status boolean
অপারেশনটি সফল হয়েছে কিনা।
data.requested_type string
প্রয়োগ করা ডোমেইন ফিল্টার।
data.plan string
বর্তমান পরিকল্পনা ট্যাগ।
data.plan_name string
বর্তমান পরিকল্পনার পাঠযোগ্য নাম।
data.allowed_types array<string>
এই অ্যাকাউন্টের জন্য ডোমেইন ফিল্টারগুলি উপলব্ধ। একটি স্বীকৃত ফিল্টার এখনও আপনার পরিকল্পনার জন্য নিষিদ্ধ হতে পারে।
data.domains array
ফিল্টার করার পরে নির্বাচিত ডোমেইন; একটি খালি অ্যারে বৈধ।
data.domains[].domain string
নির্বাচনযোগ্য ডোমেইন নাম।
data.domains[].type string
পাঠযোগ্য ডোমেইন টিয়ার লেবেল।
data.domains[].custom boolean
এটি একটি কাস্টম ডোমেইন কিনা।
POST https://v1.tempmailg.com/api/emails
#

অস্থায়ী মেলবক্স তৈরি করুন

একটি মালিকানাধীন অস্থায়ী মেইলবক্স তৈরি করুন। র্যান্ডম জেনারেশনের জন্য ব্যবহারকারীর নাম এবং ডোমেইন বাদ দিন, অথবা অনুমোদিত কাস্টম ব্যবহারকারীর নাম এবং অনুমোদিত ডোমেইন সরবরাহ করুন। প্রোভাইডার প্যারামিটারটি Gmail বা Outlook উপনাম জেনারেশন নির্বাচন করতে পারে।

প্যারামিটার 8
প্যারামিটার অবস্থান ১৩. ধরন স্থিতি ২২. বিবরণ
username body string ঐচ্ছিক
ঐচ্ছিক কাস্টম ব্যবহারকারীর নাম: ২ থেকে ৬৪টি ASCII অক্ষর, সংখ্যা, ডট, আন্ডারস্কোর বা হাইফেন। পরিকল্পনা অনুমতি প্রয়োজন; custom_username ও গ্রহণযোগ্য।
ডিফল্ট: যাদৃচ্ছিকভাবে তৈরি
domain body string ঐচ্ছিক
GET /domains দ্বারা ফেরত দেওয়া অনুমোদিত ডোমেইনগুলির একটি। বাদ দিলে একটি র্যান্ডম অনুমোদিত ডোমেইন নির্বাচন করা হয়।
ডিফল্ট: যাদৃচ্ছিক অনুমোদিত ডোমেইন
lifetime body string ঐচ্ছিক
অনুমোদিত মান:
10m — ১০ মিনিট 1h — ১ ঘণ্টা 2h — ২ ঘণ্টা 1d — ১ দিন 1w — ১ সপ্তাহ 1m — ৩০ দিন 3m — ৯০ দিন 6m — ১৮০ দিন 1y — ৩৬৫ দিন unlimited — ১৭. অসীম
ডিফল্ট: পরিকল্পনার ডিফল্ট আয়ু
provider body string ঐচ্ছিক
মেলবক্স প্রদানকারী: standard, gmail_alias, অথবা outlook_alias।
ডিফল্ট: standard
pin_enabled body boolean ঐচ্ছিক
আপনার পরিকল্পনা অনুমোদন করলে নতুন মেইলবক্সের জন্য ঐচ্ছিক PIN সুরক্ষা। এটি বিদ্যমান মেইলবক্সের PIN পরিবর্তন করে না।
ডিফল্ট: false
pin body string ঐচ্ছিক
pin_enabled সত্য হলে প্রয়োজন: ৬ থেকে ৮ অঙ্কের একটি PIN, শূন্যের পূর্বে শূন্য সংরক্ষণ করতে স্ট্রিং হিসেবে পাঠানো হয়।
pin_confirmation body string ঐচ্ছিক
pin_enabled সত্য হলে প্রয়োজন। pin-এর সঙ্গে ঠিক মিলতে হবে।
Idempotency-Key header string ঐচ্ছিক
PIN-সুরক্ষিত সৃষ্টিকরণ বা মুছে ফেলার জন্য প্রয়োজন: একটি স্থিতিশীল 16 থেকে 128 অক্ষরের কী। একই কী দিয়ে একই অনুরোধ পুনরায় চেষ্টা করুন যাতে ডুপ্লিকেট কাজ এড়ানো যায়।
ঐচ্ছিক বডি প্যারামিটারগুলি: username (যদি পরিকল্পনা অনুমোদন করে তবে কাস্টম ব্যবহারকারীর নাম), domain (অনুমোদিত ডোমেইন, উদাহরণস্বরূপ example.com), lifetime (অনুমোদিত মান: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited), provider (standard, gmail_alias, outlook_alias). লাইফটাইম বাদ দিন, অথবা এটি ফাঁকা রাখুন, যাতে আপনার বর্তমান মাসিক/বার্ষিক পরিকল্পনার জন্য কনফিগার করা ডিফল্ট ইমেইল লাইফটাইম ব্যবহার করা যায়। ডিফল্টটি ওভাররাইড করতে 1h এর মতো অনুমোদিত লাইফটাইম পাঠান। অনলিমিটেড কেবল তখনই ব্যবহার করা হয় যখন এটি পরিকল্পনার ডিফল্ট হিসেবে কনফিগার করা থাকে অথবা স্পষ্টভাবে অনুরোধ করা এবং অনুমোদিত হয়। বডি প্যারামিটারগুলো mailbox_lifetime এবং email_lifetime ও গ্রহণযোগ্য; প্রথম অ-খালি মান এই ক্রমে জয়ী হয়: lifetime, mailbox_lifetime, email_lifetime। অবৈধ বা নিষিদ্ধ মানগুলো ডিফল্ট স্বয়ংক্রিয়ভাবে নির্বাচন করার পরিবর্তে HTTP 422 রিটার্ন করে।
মেইলবক্স তৈরি করুন
curl --request POST \
  --url 'https://v1.tempmailg.com/api/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

সিন্থেটিক ডেটা ব্যবহার করে উদাহরণস্বরূপ প্রতিক্রিয়া। আইডি, ঠিকানা, টোকেন, টাইমস্ট্যাম্প, পরিকল্পনা সীমা এবং গণনা পরিবর্তিত হয়। নমুনা লাইফটাইম আপনার পরিকল্পনার ডিফল্টকে অতিক্রম করে না। প্রতিক্রিয়া ফিল্ডের বিবরণ nullable এবং প্রদানকারী-নির্দিষ্ট ফিল্ডগুলি চিহ্নিত করে।

১৪. উদাহরণ প্রতিক্রিয়া
200 OK • JSON
{
    "status": true,
    "data": {
        "id": 2301,
        "pin_protected": false,
        "email": "demo123@example.com",
        "domain": "example.com",
        "provider": "standard",
        "expire_at": "2026-11-20T02:18:14+00:00",
        "expires_in_seconds": 86399.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:18:14+00:00",
        "email_token": "encrypted-email-token"
    }
}
প্রতিক্রিয়া ক্ষেত্রসমূহ
ক্ষেত্র ১৩. ধরন ২২. বিবরণ
status boolean
অপারেশনটি সফল হয়েছে কিনা।
data.id integer
মেইলবক্স আইডি। প্রতিটি মেইলবক্সের জন্য তৈরি আইডি, ঠিকানা এবং টোকেন ভিন্ন হয়।
data.pin_protected boolean
এই মেলবক্সে PIN সুরক্ষা আছে কি না। কোনো PIN বা PIN হ্যাশ ফেরত দেওয়া হয় না।
data.email string
পূর্ণ মেলবক্স ঠিকানা তৈরি করা হয়েছে।
data.domain string
উৎপন্ন মেইলবক্সের ডোমেইন।
data.provider string
মেলবক্স প্রদানকারী: standard, gmail_alias, অথবা outlook_alias।
data.expire_at string|null
ISO-8601 টাইমস্ট্যাম্প হিসেবে কার্যকর মেয়াদ শেষ, অথবা সীমাহীন মেলবক্সের জন্য null।
data.expires_in_seconds number|null
গণনা করার সময় অবশিষ্ট অ-নেতিবাচক সেকেন্ড; ভগ্নাংশ সেকেন্ডও সম্ভব। নাল মানে সীমাহীন, শূন্য নয়।
data.mailbox_state string
বর্তমান মেলবক্সের অবস্থা: সক্রিয়, বিরত, মেয়াদোত্তীর্ণ, অথবা নিষ্ক্রিয়।
data.receiving_enabled boolean
এই মেইলবক্স বর্তমানে ইনকামিং মেসেজ গ্রহণ করে কিনা।
data.message_count integer
পরিচিত মোট বার্তা সংখ্যা; এটি শেষ মেইলবক্স সিঙ্ক্রোনাইজেশনকে প্রতিফলিত করতে পারে।
data.unread_message_count integer
পরিচিত না-পড়া বার্তার সংখ্যা; এটি শেষ মেইলবক্স সিঙ্ক্রোনাইজেশনকে প্রতিফলিত করতে পারে।
data.last_message_received_at string|null
ISO-8601 ফরম্যাটে সর্বশেষ জানা প্রাপ্ত-বার্তার সময়, অথবা অনুপলব্ধ হলে null।
data.message_count_synced_at string|null
ISO-8601 ফরম্যাটে শেষ বার্তা-গণনা সিঙ্ক্রোনাইজেশন সময়, অথবা সিঙ্ক্রোনাইজেশনের আগে null।
data.created_at string|null
ISO-8601 ফরম্যাটে মেলবক্স তৈরির সময়।
data.email_token string
অস্বচ্ছ এনক্রিপ্টেড মেলবক্স রেফারেন্স। এটি Bearer প্রমাণীকরণ, মালিকানা যাচাই বা PIN অনুমোদন প্রতিস্থাপন করে না।
data.pin_grant object
শর্তসাপেক্ষ: সক্রিয় PIN-সুরক্ষিত মেলবক্স তৈরি এই রিড গ্রান্ট ফেরত দেয়; সাধারণ অরক্ষিত তৈরি এটি বাদ দেয়।
data.pin_grant.mailbox_id integer
শর্তসাপেক্ষে রিড গ্রান্ট যেটিতে বাঁধা আছে সেই মেলবক্স আইডি।
data.pin_grant.unlock_token string
একই মালিকের ক্রেডেনশিয়াল সহ X-Mailbox-Unlock এর জন্য অস্বচ্ছ রিড টোকেন। এটি ব্যক্তিগতভাবে এবং মেমরিতে রাখুন; একটি রিড গ্র্যান্ট মুছে ফেলার অনুমোদন দেয় না।
data.pin_grant.scope string
শর্তসাপেক্ষ সৃষ্টির অনুদানের জন্য স্কোপটি পড়া হয়েছে।
data.pin_grant.idle_timeout_seconds integer
রিড গ্রান্টের জন্য অনুমোদিত নিষ্ক্রিয় সময়, সাধারণত ৩৬০০ সেকেন্ড।
data.pin_grant.absolute_timeout_seconds integer
রিড গ্রান্টের সর্বোচ্চ আয়ু, সাধারণত 86400 সেকেন্ড।
data.pin_grant.expires_at string
ISO-8601 ফরম্যাটে বর্তমান রিড-গ্রান্টের মেয়াদ শেষ।
data.pin_grant.absolute_expires_at string
ISO-8601 ফরম্যাটে সম্পূর্ণ রিড-গ্রান্টের মেয়াদ শেষ। নিরাপত্তা পরিবর্তনগুলি গ্রান্টটি আগে বাতিল করতে পারে।
POST https://v1.tempmailg.com/api/emails/{email}/{username}/{domain}
#

আপডেট / মেলবক্স পরিবর্তন

বর্তমান মেইলবক্সের মালিকানা যাচাই করার পরে নতুন ব্যবহারকারীর নাম এবং ডোমেইনে একটি মেইলবক্স তৈরি করুন বা নির্বাচন করুন। এটি পুরোনো মেইলবক্সের নাম পরিবর্তন করে না বা তার আয়ু স্থানে পরিবর্তন করে না। যখন গন্তব্য ভিন্ন হয়, পুরোনো মেইলবক্স ইতিহাসে থাকে এবং সক্রিয়-মেইলবক্স সীমা দ্বারা স্থগিত হতে পারে। আপনার নিজস্ব সক্রিয় গন্তব্য পুনরায় ব্যবহার করলে তার অনুরোধকৃত আয়ু বা পরিকল্পনার ডিফল্ট পুনরায় প্রয়োগ হয়।

প্যারামিটার 9
প্যারামিটার অবস্থান ১৩. ধরন স্থিতি ২২. বিবরণ
email path string প্রয়োজনীয়
সুইচ করার জন্য মালিকানাধীন মেলবক্সের বর্তমান পূর্ণ ইমেল ঠিকানা। প্রতিটি পাথ সেগমেন্ট URL-এনকোড করুন; প্লাস চিহ্নকে %2B হিসেবে এনকোড করুন।
username path string প্রয়োজনীয়
নতুন কাঙ্ক্ষিত ব্যবহারকারীর নাম: ২ থেকে ৬৪টি আলফানিউমেরিক অক্ষর; কাস্টম ব্যবহারকারীর নাম অনুমতির অধীন।
domain path string প্রয়োজনীয়
নতুন অনুমোদিত ডোমেইন নাম।
lifetime body string ঐচ্ছিক
অনুমোদিত মান:
10m — ১০ মিনিট 1h — ১ ঘণ্টা 2h — ২ ঘণ্টা 1d — ১ দিন 1w — ১ সপ্তাহ 1m — ৩০ দিন 3m — ৯০ দিন 6m — ১৮০ দিন 1y — ৩৬৫ দিন unlimited — ১৭. অসীম
ডিফল্ট: পরিকল্পনার ডিফল্ট আয়ু
pin_enabled body boolean ঐচ্ছিক
আপনার পরিকল্পনা অনুমোদন করলে নতুন মেইলবক্সের জন্য ঐচ্ছিক PIN সুরক্ষা। এটি বিদ্যমান মেইলবক্সের PIN পরিবর্তন করে না।
ডিফল্ট: false
pin body string ঐচ্ছিক
pin_enabled সত্য হলে প্রয়োজন: ৬ থেকে ৮ অঙ্কের একটি PIN, শূন্যের পূর্বে শূন্য সংরক্ষণ করতে স্ট্রিং হিসেবে পাঠানো হয়।
pin_confirmation body string ঐচ্ছিক
pin_enabled সত্য হলে প্রয়োজন। pin-এর সঙ্গে ঠিক মিলতে হবে।
Idempotency-Key header string ঐচ্ছিক
PIN-সুরক্ষিত সৃষ্টিকরণ বা মুছে ফেলার জন্য প্রয়োজন: একটি স্থিতিশীল 16 থেকে 128 অক্ষরের কী। একই কী দিয়ে একই অনুরোধ পুনরায় চেষ্টা করুন যাতে ডুপ্লিকেট কাজ এড়ানো যায়।
X-Mailbox-Unlock header string ঐচ্ছিক
শিরোনাম, শুধুমাত্র সুরক্ষিত মেলবক্স: একটি রিড unlock_token ব্যবহার করুন। প্রথমে PIN এবং scope=read সহ POST করুন PIN unlock URL-এ। আপনার স্বাভাবিক Bearer প্রমাণীকরণ বজায় রাখুন। <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
১৮. {email} এ একটি বিদ্যমান মালিকানাধীন মেইলবক্স ইমেল ব্যবহার করুন। ঐচ্ছিক বডি প্যারামিটার: lifetime (অনুমোদিত মান: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited)। লাইফটাইম বাদ দিন, অথবা এটি ফাঁকা রাখুন, যাতে আপনার বর্তমান মাসিক/বার্ষিক পরিকল্পনার জন্য কনফিগার করা ডিফল্ট ইমেইল লাইফটাইম ব্যবহার করা যায়। ডিফল্টটি ওভাররাইড করতে 1h এর মতো অনুমোদিত লাইফটাইম পাঠান। অনলিমিটেড কেবল তখনই ব্যবহার করা হয় যখন এটি পরিকল্পনার ডিফল্ট হিসেবে কনফিগার করা থাকে অথবা স্পষ্টভাবে অনুরোধ করা এবং অনুমোদিত হয়। বডি প্যারামিটারগুলো mailbox_lifetime এবং email_lifetime ও গ্রহণযোগ্য; প্রথম অ-খালি মান এই ক্রমে জয়ী হয়: lifetime, mailbox_lifetime, email_lifetime। অবৈধ বা নিষিদ্ধ মানগুলো ডিফল্ট স্বয়ংক্রিয়ভাবে নির্বাচন করার পরিবর্তে HTTP 422 রিটার্ন করে।
১৯. মালিকানাধীন মেইলবক্স আপডেট করুন
curl --request POST \
  --url 'https://v1.tempmailg.com/api/emails/current@example.com/demo123/example.com' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

সিন্থেটিক ডেটা ব্যবহার করে উদাহরণস্বরূপ প্রতিক্রিয়া। আইডি, ঠিকানা, টোকেন, টাইমস্ট্যাম্প, পরিকল্পনা সীমা এবং গণনা পরিবর্তিত হয়। নমুনা লাইফটাইম আপনার পরিকল্পনার ডিফল্টকে অতিক্রম করে না। প্রতিক্রিয়া ফিল্ডের বিবরণ nullable এবং প্রদানকারী-নির্দিষ্ট ফিল্ডগুলি চিহ্নিত করে।

১৪. উদাহরণ প্রতিক্রিয়া
200 OK • JSON
{
    "status": true,
    "data": {
        "id": 2302,
        "pin_protected": false,
        "email": "demo123@example.com",
        "domain": "example.com",
        "provider": "standard",
        "expire_at": "2026-11-19T02:28:14+00:00",
        "expires_in_seconds": 599.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:18:14+00:00",
        "email_token": "encrypted-email-token"
    }
}
প্রতিক্রিয়া ক্ষেত্রসমূহ
ক্ষেত্র ১৩. ধরন ২২. বিবরণ
status boolean
অপারেশনটি সফল হয়েছে কিনা।
data.id integer
মেইলবক্স আইডি। প্রতিটি মেইলবক্সের জন্য তৈরি আইডি, ঠিকানা এবং টোকেন ভিন্ন হয়।
data.pin_protected boolean
এই মেলবক্সে PIN সুরক্ষা আছে কি না। কোনো PIN বা PIN হ্যাশ ফেরত দেওয়া হয় না।
data.email string
পূর্ণ মেলবক্স ঠিকানা তৈরি করা হয়েছে।
data.domain string
উৎপন্ন মেইলবক্সের ডোমেইন।
data.provider string
মেলবক্স প্রদানকারী: standard, gmail_alias, অথবা outlook_alias।
data.expire_at string|null
ISO-8601 টাইমস্ট্যাম্প হিসেবে কার্যকর মেয়াদ শেষ, অথবা সীমাহীন মেলবক্সের জন্য null।
data.expires_in_seconds number|null
গণনা করার সময় অবশিষ্ট অ-নেতিবাচক সেকেন্ড; ভগ্নাংশ সেকেন্ডও সম্ভব। নাল মানে সীমাহীন, শূন্য নয়।
data.mailbox_state string
বর্তমান মেলবক্সের অবস্থা: সক্রিয়, বিরত, মেয়াদোত্তীর্ণ, অথবা নিষ্ক্রিয়।
data.receiving_enabled boolean
এই মেইলবক্স বর্তমানে ইনকামিং মেসেজ গ্রহণ করে কিনা।
data.message_count integer
পরিচিত মোট বার্তা সংখ্যা; এটি শেষ মেইলবক্স সিঙ্ক্রোনাইজেশনকে প্রতিফলিত করতে পারে।
data.unread_message_count integer
পরিচিত না-পড়া বার্তার সংখ্যা; এটি শেষ মেইলবক্স সিঙ্ক্রোনাইজেশনকে প্রতিফলিত করতে পারে।
data.last_message_received_at string|null
ISO-8601 ফরম্যাটে সর্বশেষ জানা প্রাপ্ত-বার্তার সময়, অথবা অনুপলব্ধ হলে null।
data.message_count_synced_at string|null
ISO-8601 ফরম্যাটে শেষ বার্তা-গণনা সিঙ্ক্রোনাইজেশন সময়, অথবা সিঙ্ক্রোনাইজেশনের আগে null।
data.created_at string|null
ISO-8601 ফরম্যাটে মেলবক্স তৈরির সময়।
data.email_token string
অস্বচ্ছ এনক্রিপ্টেড মেলবক্স রেফারেন্স। এটি Bearer প্রমাণীকরণ, মালিকানা যাচাই বা PIN অনুমোদন প্রতিস্থাপন করে না।
data.pin_grant object
শর্তসাপেক্ষ: সক্রিয় PIN-সুরক্ষিত মেলবক্স তৈরি এই রিড গ্রান্ট ফেরত দেয়; সাধারণ অরক্ষিত তৈরি এটি বাদ দেয়।
data.pin_grant.mailbox_id integer
শর্তসাপেক্ষে রিড গ্রান্ট যেটিতে বাঁধা আছে সেই মেলবক্স আইডি।
data.pin_grant.unlock_token string
একই মালিকের ক্রেডেনশিয়াল সহ X-Mailbox-Unlock এর জন্য অস্বচ্ছ রিড টোকেন। এটি ব্যক্তিগতভাবে এবং মেমরিতে রাখুন; একটি রিড গ্র্যান্ট মুছে ফেলার অনুমোদন দেয় না।
data.pin_grant.scope string
শর্তসাপেক্ষ সৃষ্টির অনুদানের জন্য স্কোপটি পড়া হয়েছে।
data.pin_grant.idle_timeout_seconds integer
রিড গ্রান্টের জন্য অনুমোদিত নিষ্ক্রিয় সময়, সাধারণত ৩৬০০ সেকেন্ড।
data.pin_grant.absolute_timeout_seconds integer
রিড গ্রান্টের সর্বোচ্চ আয়ু, সাধারণত 86400 সেকেন্ড।
data.pin_grant.expires_at string
ISO-8601 ফরম্যাটে বর্তমান রিড-গ্রান্টের মেয়াদ শেষ।
data.pin_grant.absolute_expires_at string
ISO-8601 ফরম্যাটে সম্পূর্ণ রিড-গ্রান্টের মেয়াদ শেষ। নিরাপত্তা পরিবর্তনগুলি গ্রান্টটি আগে বাতিল করতে পারে।
DELETE https://v1.tempmailg.com/api/emails/{email}
#

মেলবক্স মুছে ফেলুন

একটি মালিকানাধীন মেইলবক্স মুছে ফেলুন এবং তার বার্তা ও ফাইল পরিষ্কার করুন। সংরক্ষিত মেইলবক্স রেকর্ডগুলি অভ্যন্তরীণভাবে সফট-ডিলিট করা হতে পারে; ঠিকানাটি আর API মাধ্যমে ব্যবহারযোগ্য নয়।

প্যারামিটার 3
প্যারামিটার অবস্থান ১৩. ধরন স্থিতি ২২. বিবরণ
email path string প্রয়োজনীয়
মুছে ফেলার জন্য মালিকানাধীন মেলবক্সের পূর্ণ ইমেল ঠিকানা। ঠিকানাটি URL-এনকোড করুন; প্লাস চিহ্নকে %2B হিসেবে এনকোড করুন।
X-Mailbox-Unlock header string ঐচ্ছিক
শিরোনাম, শুধুমাত্র সুরক্ষিত মেইলবক্স: একবার ব্যবহারযোগ্য ডিলিট unlock_token ব্যবহার করুন। প্রথমে POST pin, scope=delete এবং 423 প্রতিক্রিয়া থেকে প্রাপ্ত action/target_id PIN unlock URL-এ। একটি রিড টোকেন ডিলিট করতে পারে না। <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Idempotency-Key header string ঐচ্ছিক
PIN-সুরক্ষিত সৃষ্টিকরণ বা মুছে ফেলার জন্য প্রয়োজন: একটি স্থিতিশীল 16 থেকে 128 অক্ষরের কী। একই কী দিয়ে একই অনুরোধ পুনরায় চেষ্টা করুন যাতে ডুপ্লিকেট কাজ এড়ানো যায়।
২০. মালিকানাধীন মেইলবক্স মুছে ফেলুন
curl --request DELETE \
  --url 'https://v1.tempmailg.com/api/emails/demo123@example.com' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

সিন্থেটিক ডেটা ব্যবহার করে উদাহরণস্বরূপ প্রতিক্রিয়া। আইডি, ঠিকানা, টোকেন, টাইমস্ট্যাম্প, পরিকল্পনা সীমা এবং গণনা পরিবর্তিত হয়। নমুনা লাইফটাইম আপনার পরিকল্পনার ডিফল্টকে অতিক্রম করে না। প্রতিক্রিয়া ফিল্ডের বিবরণ nullable এবং প্রদানকারী-নির্দিষ্ট ফিল্ডগুলি চিহ্নিত করে।

১৪. উদাহরণ প্রতিক্রিয়া
200 OK • JSON
{
    "status": true,
    "message": "Email has been successfully deleted."
}
প্রতিক্রিয়া ক্ষেত্রসমূহ
ক্ষেত্র ১৩. ধরন ২২. বিবরণ
status boolean
অপারেশনটি সফল হয়েছে কিনা।
message string
মুছে ফেলার ফলাফল। একটি অনুপস্থিত রিসোর্স HTTP 404 রিটার্ন করে।

জিমেইল & আউটলুক উপনাম

উচ্চ-প্রতিষ্ঠিত Gmail এবং Outlook/Hotmail উপনাম মেলবক্স তৈরি করুন।

POST https://v1.tempmailg.com/api/gmail-alias/emails
#

Gmail উপনাম তৈরি করুন

প্রমাণিত ব্যবহারকারীর মালিকানাধীন একটি নতুন Gmail উপনাম অস্থায়ী মেইলবক্স তৈরি করুন।

প্যারামিটার 8
প্যারামিটার অবস্থান ১৩. ধরন স্থিতি ২২. বিবরণ
mode body string ঐচ্ছিক
জেনারেশন মোড: auto, dot, plus, অথবা plus_dot। এছাড়াও gmail_alias_mode গ্রহণ করে। যদি স্টাইল নির্বাচন অনুমোদিত না হয়, auto ব্যবহার করা হয়।
ডিফল্ট: auto
username body string ঐচ্ছিক
ঐচ্ছিক কাস্টম উপনাম সাফিক্স: ২ থেকে ৩২টি ASCII অক্ষর বা সংখ্যা, ছোটহরফে স্বাভাবিকীকৃত; বৈশিষ্ট্য অনুমতির অধীন। এছাড়াও custom_username বা alias_username গ্রহণ করে।
ডিফল্ট: স্বয়ংক্রিয়ভাবে তৈরি
domain body string ঐচ্ছিক
র‌্যান্ডম, gmail.com বা googlemail.com ব্যবহার করুন; alias_domain-ও গ্রহণযোগ্য। বাদ দেওয়া বা অপ্রাপ্য ডোমেইন-নির্বাচন অনুমতি র‌্যান্ডম ব্যবহার করে।
ডিফল্ট: random
lifetime body string ঐচ্ছিক
অনুমোদিত মান:
10m — ১০ মিনিট 1h — ১ ঘণ্টা 2h — ২ ঘণ্টা 1d — ১ দিন 1w — ১ সপ্তাহ 1m — ৩০ দিন 3m — ৯০ দিন 6m — ১৮০ দিন 1y — ৩৬৫ দিন unlimited — ১৭. অসীম
ডিফল্ট: পরিকল্পনার ডিফল্ট আয়ু
pin_enabled body boolean ঐচ্ছিক
আপনার পরিকল্পনা অনুমোদন করলে নতুন মেইলবক্সের জন্য ঐচ্ছিক PIN সুরক্ষা। এটি বিদ্যমান মেইলবক্সের PIN পরিবর্তন করে না।
ডিফল্ট: false
pin body string ঐচ্ছিক
pin_enabled সত্য হলে প্রয়োজন: ৬ থেকে ৮ অঙ্কের একটি PIN, শূন্যের পূর্বে শূন্য সংরক্ষণ করতে স্ট্রিং হিসেবে পাঠানো হয়।
pin_confirmation body string ঐচ্ছিক
pin_enabled সত্য হলে প্রয়োজন। pin-এর সঙ্গে ঠিক মিলতে হবে।
Idempotency-Key header string ঐচ্ছিক
PIN-সুরক্ষিত সৃষ্টিকরণ বা মুছে ফেলার জন্য প্রয়োজন: একটি স্থিতিশীল 16 থেকে 128 অক্ষরের কী। একই কী দিয়ে একই অনুরোধ পুনরায় চেষ্টা করুন যাতে ডুপ্লিকেট কাজ এড়ানো যায়।
আপনার সাবস্ক্রিপশন প্ল্যানে Gmail Alias API অনুমতি সক্রিয় করা বা API ক্রেডিট প্যাকেজের মাধ্যমে আনলক করা প্রয়োজন। ঐচ্ছিক প্যারামিটারগুলি: mode (auto, dot, plus, plus_dot), username (কাস্টম উপনাম ব্যবহারকারীর নাম), domain (যেমন: gmail.com, googlemail.com), lifetime (অনুমোদিত মান: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). লাইফটাইম বাদ দিন, অথবা এটি ফাঁকা রাখুন, যাতে আপনার বর্তমান মাসিক/বার্ষিক পরিকল্পনার জন্য কনফিগার করা ডিফল্ট ইমেইল লাইফটাইম ব্যবহার করা যায়। ডিফল্টটি ওভাররাইড করতে 1h এর মতো অনুমোদিত লাইফটাইম পাঠান। অনলিমিটেড কেবল তখনই ব্যবহার করা হয় যখন এটি পরিকল্পনার ডিফল্ট হিসেবে কনফিগার করা থাকে অথবা স্পষ্টভাবে অনুরোধ করা এবং অনুমোদিত হয়। বডি প্যারামিটারগুলো mailbox_lifetime এবং email_lifetime ও গ্রহণযোগ্য; প্রথম অ-খালি মান এই ক্রমে জয়ী হয়: lifetime, mailbox_lifetime, email_lifetime। অবৈধ বা নিষিদ্ধ মানগুলো ডিফল্ট স্বয়ংক্রিয়ভাবে নির্বাচন করার পরিবর্তে HTTP 422 রিটার্ন করে।
Gmail উপনাম মেলবক্স তৈরি করুন
curl --request POST \
  --url 'https://v1.tempmailg.com/api/gmail-alias/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

সিন্থেটিক ডেটা ব্যবহার করে উদাহরণস্বরূপ প্রতিক্রিয়া। আইডি, ঠিকানা, টোকেন, টাইমস্ট্যাম্প, পরিকল্পনা সীমা এবং গণনা পরিবর্তিত হয়। নমুনা লাইফটাইম আপনার পরিকল্পনার ডিফল্টকে অতিক্রম করে না। প্রতিক্রিয়া ফিল্ডের বিবরণ nullable এবং প্রদানকারী-নির্দিষ্ট ফিল্ডগুলি চিহ্নিত করে।

১৪. উদাহরণ প্রতিক্রিয়া
200 OK • JSON
{
    "status": true,
    "data": {
        "id": 2305,
        "pin_protected": false,
        "email": "example+alias123@gmail.com",
        "domain": "gmail.com",
        "provider": "gmail_alias",
        "expire_at": "2026-11-19T03:18:14+00:00",
        "expires_in_seconds": 3599.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:18:14+00:00",
        "email_token": "encrypted-email-token"
    }
}
প্রতিক্রিয়া ক্ষেত্রসমূহ
ক্ষেত্র ১৩. ধরন ২২. বিবরণ
status boolean
অপারেশনটি সফল হয়েছে কিনা।
data.id integer
মেইলবক্স আইডি। প্রতিটি মেইলবক্সের জন্য তৈরি আইডি, ঠিকানা এবং টোকেন ভিন্ন হয়।
data.pin_protected boolean
এই মেলবক্সে PIN সুরক্ষা আছে কি না। কোনো PIN বা PIN হ্যাশ ফেরত দেওয়া হয় না।
data.email string
পূর্ণ মেলবক্স ঠিকানা তৈরি করা হয়েছে।
data.domain string
উৎপন্ন মেইলবক্সের ডোমেইন।
data.provider string
মেলবক্স প্রদানকারী: standard, gmail_alias, অথবা outlook_alias।
data.expire_at string|null
ISO-8601 টাইমস্ট্যাম্প হিসেবে কার্যকর মেয়াদ শেষ, অথবা সীমাহীন মেলবক্সের জন্য null।
data.expires_in_seconds number|null
গণনা করার সময় অবশিষ্ট অ-নেতিবাচক সেকেন্ড; ভগ্নাংশ সেকেন্ডও সম্ভব। নাল মানে সীমাহীন, শূন্য নয়।
data.mailbox_state string
বর্তমান মেলবক্সের অবস্থা: সক্রিয়, বিরত, মেয়াদোত্তীর্ণ, অথবা নিষ্ক্রিয়।
data.receiving_enabled boolean
এই মেইলবক্স বর্তমানে ইনকামিং মেসেজ গ্রহণ করে কিনা।
data.message_count integer
পরিচিত মোট বার্তা সংখ্যা; এটি শেষ মেইলবক্স সিঙ্ক্রোনাইজেশনকে প্রতিফলিত করতে পারে।
data.unread_message_count integer
পরিচিত না-পড়া বার্তার সংখ্যা; এটি শেষ মেইলবক্স সিঙ্ক্রোনাইজেশনকে প্রতিফলিত করতে পারে।
data.last_message_received_at string|null
ISO-8601 ফরম্যাটে সর্বশেষ জানা প্রাপ্ত-বার্তার সময়, অথবা অনুপলব্ধ হলে null।
data.message_count_synced_at string|null
ISO-8601 ফরম্যাটে শেষ বার্তা-গণনা সিঙ্ক্রোনাইজেশন সময়, অথবা সিঙ্ক্রোনাইজেশনের আগে null।
data.created_at string|null
ISO-8601 ফরম্যাটে মেলবক্স তৈরির সময়।
data.email_token string
অস্বচ্ছ এনক্রিপ্টেড মেলবক্স রেফারেন্স। এটি Bearer প্রমাণীকরণ, মালিকানা যাচাই বা PIN অনুমোদন প্রতিস্থাপন করে না।
data.pin_grant object
শর্তসাপেক্ষ: সক্রিয় PIN-সুরক্ষিত মেলবক্স তৈরি এই রিড গ্রান্ট ফেরত দেয়; সাধারণ অরক্ষিত তৈরি এটি বাদ দেয়।
data.pin_grant.mailbox_id integer
শর্তসাপেক্ষে রিড গ্রান্ট যেটিতে বাঁধা আছে সেই মেলবক্স আইডি।
data.pin_grant.unlock_token string
একই মালিকের ক্রেডেনশিয়াল সহ X-Mailbox-Unlock এর জন্য অস্বচ্ছ রিড টোকেন। এটি ব্যক্তিগতভাবে এবং মেমরিতে রাখুন; একটি রিড গ্র্যান্ট মুছে ফেলার অনুমোদন দেয় না।
data.pin_grant.scope string
শর্তসাপেক্ষ সৃষ্টির অনুদানের জন্য স্কোপটি পড়া হয়েছে।
data.pin_grant.idle_timeout_seconds integer
রিড গ্রান্টের জন্য অনুমোদিত নিষ্ক্রিয় সময়, সাধারণত ৩৬০০ সেকেন্ড।
data.pin_grant.absolute_timeout_seconds integer
রিড গ্রান্টের সর্বোচ্চ আয়ু, সাধারণত 86400 সেকেন্ড।
data.pin_grant.expires_at string
ISO-8601 ফরম্যাটে বর্তমান রিড-গ্রান্টের মেয়াদ শেষ।
data.pin_grant.absolute_expires_at string
ISO-8601 ফরম্যাটে সম্পূর্ণ রিড-গ্রান্টের মেয়াদ শেষ। নিরাপত্তা পরিবর্তনগুলি গ্রান্টটি আগে বাতিল করতে পারে।
GET https://v1.tempmailg.com/api/outlook-alias/domains
#

Outlook উপনাম ডোমেইন

মেইলবক্স জেনারেশনের জন্য উপলব্ধ সক্রিয় Outlook / Hotmail উপনাম ডোমেইনগুলি সংগ্রহ করুন।

আপনার সাবস্ক্রিপশন পরিকল্পনায় Outlook Alias API অনুমতি সক্রিয় থাকতে হবে অথবা API ক্রেডিট প্যাকেজের মাধ্যমে আনলক করতে হবে। আপনার পরিকল্পনায় নির্দিষ্ট ডোমেইন নির্বাচন আনলক করা হয়েছে কিনা তা নির্দেশ করে।
Outlook উপনাম ডোমেইনগুলি পান
curl --request GET \
  --url 'https://v1.tempmailg.com/api/outlook-alias/domains' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

সিন্থেটিক ডেটা ব্যবহার করে উদাহরণস্বরূপ প্রতিক্রিয়া। আইডি, ঠিকানা, টোকেন, টাইমস্ট্যাম্প, পরিকল্পনা সীমা এবং গণনা পরিবর্তিত হয়। নমুনা লাইফটাইম আপনার পরিকল্পনার ডিফল্টকে অতিক্রম করে না। প্রতিক্রিয়া ফিল্ডের বিবরণ nullable এবং প্রদানকারী-নির্দিষ্ট ফিল্ডগুলি চিহ্নিত করে।

১৪. উদাহরণ প্রতিক্রিয়া
200 OK • JSON
{
    "status": true,
    "data": {
        "domains": [
            {
                "domain": "outlook.com",
                "type": "Outlook/Hotmail",
                "selectable": true,
                "locked": false,
                "disabled_reason": null
            },
            {
                "domain": "hotmail.com",
                "type": "Outlook/Hotmail",
                "selectable": true,
                "locked": false,
                "disabled_reason": null
            }
        ]
    }
}
প্রতিক্রিয়া ক্ষেত্রসমূহ
ক্ষেত্র ১৩. ধরন ২২. বিবরণ
status boolean
অপারেশনটি সফল হয়েছে কিনা।
data.domains array
সক্রিয় Outlook/Hotmail ডোমেইন; একটি খালি অ্যারে বৈধ।
data.domains[].domain string
উপলব্ধ ডোমেইন নাম।
data.domains[].type string
পাঠযোগ্য প্রদানকারী লেবেল।
data.domains[].selectable boolean
আপনার অ্যাকাউন্ট কি স্পষ্টভাবে এই ডোমেইনটি বেছে নিতে পারে।
data.domains[].locked boolean
আপনার অ্যাকাউন্টের জন্য স্পষ্ট ডোমেইন নির্বাচন লক করা আছে কিনা।
data.domains[].disabled_reason string|null
ডোমেইন নির্বাচন লক হওয়ার কারণ, অথবা নির্বাচনের সময় null।
POST https://v1.tempmailg.com/api/outlook-alias/emails
#

Outlook উপনাম তৈরি করুন

প্রমাণিত ব্যবহারকারীর মালিকানাধীন একটি নতুন Outlook / Hotmail উপনাম অস্থায়ী মেইলবক্স তৈরি করুন।

প্যারামিটার 7
প্যারামিটার অবস্থান ১৩. ধরন স্থিতি ২২. বিবরণ
domain body string ঐচ্ছিক
র্যান্ডম অথবা GET /outlook-alias/domains থেকে একটি ডোমেইন ব্যবহার করুন; outlook_alias_domain ও গ্রহণযোগ্য। নির্বাচন অনুমতি না থাকলে, র্যান্ডম ব্যবহার করা হবে।
ডিফল্ট: যথেচ্ছা উপলব্ধ ডোমেইন
username body string ঐচ্ছিক
ঐচ্ছিক কাস্টম উপনাম সাফিক্স: ২ থেকে ৩২টি ASCII অক্ষর বা সংখ্যা, ছোটহরফে স্বাভাবিকীকৃত; বৈশিষ্ট্য অনুমতির অধীন। এছাড়াও custom_username বা alias_username গ্রহণ করে।
ডিফল্ট: স্বয়ংক্রিয়ভাবে তৈরি
lifetime body string ঐচ্ছিক
অনুমোদিত মান:
10m — ১০ মিনিট 1h — ১ ঘণ্টা 2h — ২ ঘণ্টা 1d — ১ দিন 1w — ১ সপ্তাহ 1m — ৩০ দিন 3m — ৯০ দিন 6m — ১৮০ দিন 1y — ৩৬৫ দিন unlimited — ১৭. অসীম
ডিফল্ট: পরিকল্পনার ডিফল্ট আয়ু
pin_enabled body boolean ঐচ্ছিক
আপনার পরিকল্পনা অনুমোদন করলে নতুন মেইলবক্সের জন্য ঐচ্ছিক PIN সুরক্ষা। এটি বিদ্যমান মেইলবক্সের PIN পরিবর্তন করে না।
ডিফল্ট: false
pin body string ঐচ্ছিক
pin_enabled সত্য হলে প্রয়োজন: ৬ থেকে ৮ অঙ্কের একটি PIN, শূন্যের পূর্বে শূন্য সংরক্ষণ করতে স্ট্রিং হিসেবে পাঠানো হয়।
pin_confirmation body string ঐচ্ছিক
pin_enabled সত্য হলে প্রয়োজন। pin-এর সঙ্গে ঠিক মিলতে হবে।
Idempotency-Key header string ঐচ্ছিক
PIN-সুরক্ষিত সৃষ্টিকরণ বা মুছে ফেলার জন্য প্রয়োজন: একটি স্থিতিশীল 16 থেকে 128 অক্ষরের কী। একই কী দিয়ে একই অনুরোধ পুনরায় চেষ্টা করুন যাতে ডুপ্লিকেট কাজ এড়ানো যায়।
আপনার সাবস্ক্রিপশন পরিকল্পনায় Outlook Alias API অনুমতি সক্রিয় থাকতে হবে অথবা API ক্রেডিট প্যাকেজের মাধ্যমে আনলক করতে হবে। ঐচ্ছিক প্যারামিটারগুলি: domain (যেমন outlook.com, hotmail.com), username (কাস্টম উপনাম ব্যবহারকারীর নাম), lifetime (অনুমোদিত মান: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). লাইফটাইম বাদ দিন, অথবা এটি ফাঁকা রাখুন, যাতে আপনার বর্তমান মাসিক/বার্ষিক পরিকল্পনার জন্য কনফিগার করা ডিফল্ট ইমেইল লাইফটাইম ব্যবহার করা যায়। ডিফল্টটি ওভাররাইড করতে 1h এর মতো অনুমোদিত লাইফটাইম পাঠান। অনলিমিটেড কেবল তখনই ব্যবহার করা হয় যখন এটি পরিকল্পনার ডিফল্ট হিসেবে কনফিগার করা থাকে অথবা স্পষ্টভাবে অনুরোধ করা এবং অনুমোদিত হয়। বডি প্যারামিটারগুলো mailbox_lifetime এবং email_lifetime ও গ্রহণযোগ্য; প্রথম অ-খালি মান এই ক্রমে জয়ী হয়: lifetime, mailbox_lifetime, email_lifetime। অবৈধ বা নিষিদ্ধ মানগুলো ডিফল্ট স্বয়ংক্রিয়ভাবে নির্বাচন করার পরিবর্তে HTTP 422 রিটার্ন করে।
Outlook উপনাম মেলবক্স তৈরি করুন
curl --request POST \
  --url 'https://v1.tempmailg.com/api/outlook-alias/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

সিন্থেটিক ডেটা ব্যবহার করে উদাহরণস্বরূপ প্রতিক্রিয়া। আইডি, ঠিকানা, টোকেন, টাইমস্ট্যাম্প, পরিকল্পনা সীমা এবং গণনা পরিবর্তিত হয়। নমুনা লাইফটাইম আপনার পরিকল্পনার ডিফল্টকে অতিক্রম করে না। প্রতিক্রিয়া ফিল্ডের বিবরণ nullable এবং প্রদানকারী-নির্দিষ্ট ফিল্ডগুলি চিহ্নিত করে।

১৪. উদাহরণ প্রতিক্রিয়া
200 OK • JSON
{
    "status": true,
    "data": {
        "id": 2306,
        "pin_protected": false,
        "email": "example+alias45@outlook.com",
        "domain": "outlook.com",
        "provider": "outlook_alias",
        "expire_at": "2026-11-19T03:18:14+00:00",
        "expires_in_seconds": 3599.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:18:14+00:00",
        "email_token": "encrypted-email-token"
    }
}
প্রতিক্রিয়া ক্ষেত্রসমূহ
ক্ষেত্র ১৩. ধরন ২২. বিবরণ
status boolean
অপারেশনটি সফল হয়েছে কিনা।
data.id integer
মেইলবক্স আইডি। প্রতিটি মেইলবক্সের জন্য তৈরি আইডি, ঠিকানা এবং টোকেন ভিন্ন হয়।
data.pin_protected boolean
এই মেলবক্সে PIN সুরক্ষা আছে কি না। কোনো PIN বা PIN হ্যাশ ফেরত দেওয়া হয় না।
data.email string
পূর্ণ মেলবক্স ঠিকানা তৈরি করা হয়েছে।
data.domain string
উৎপন্ন মেইলবক্সের ডোমেইন।
data.provider string
মেলবক্স প্রদানকারী: standard, gmail_alias, অথবা outlook_alias।
data.expire_at string|null
ISO-8601 টাইমস্ট্যাম্প হিসেবে কার্যকর মেয়াদ শেষ, অথবা সীমাহীন মেলবক্সের জন্য null।
data.expires_in_seconds number|null
গণনা করার সময় অবশিষ্ট অ-নেতিবাচক সেকেন্ড; ভগ্নাংশ সেকেন্ডও সম্ভব। নাল মানে সীমাহীন, শূন্য নয়।
data.mailbox_state string
বর্তমান মেলবক্সের অবস্থা: সক্রিয়, বিরত, মেয়াদোত্তীর্ণ, অথবা নিষ্ক্রিয়।
data.receiving_enabled boolean
এই মেইলবক্স বর্তমানে ইনকামিং মেসেজ গ্রহণ করে কিনা।
data.message_count integer
পরিচিত মোট বার্তা সংখ্যা; এটি শেষ মেইলবক্স সিঙ্ক্রোনাইজেশনকে প্রতিফলিত করতে পারে।
data.unread_message_count integer
পরিচিত না-পড়া বার্তার সংখ্যা; এটি শেষ মেইলবক্স সিঙ্ক্রোনাইজেশনকে প্রতিফলিত করতে পারে।
data.last_message_received_at string|null
ISO-8601 ফরম্যাটে সর্বশেষ জানা প্রাপ্ত-বার্তার সময়, অথবা অনুপলব্ধ হলে null।
data.message_count_synced_at string|null
ISO-8601 ফরম্যাটে শেষ বার্তা-গণনা সিঙ্ক্রোনাইজেশন সময়, অথবা সিঙ্ক্রোনাইজেশনের আগে null।
data.created_at string|null
ISO-8601 ফরম্যাটে মেলবক্স তৈরির সময়।
data.email_token string
অস্বচ্ছ এনক্রিপ্টেড মেলবক্স রেফারেন্স। এটি Bearer প্রমাণীকরণ, মালিকানা যাচাই বা PIN অনুমোদন প্রতিস্থাপন করে না।
data.pin_grant object
শর্তসাপেক্ষ: সক্রিয় PIN-সুরক্ষিত মেলবক্স তৈরি এই রিড গ্রান্ট ফেরত দেয়; সাধারণ অরক্ষিত তৈরি এটি বাদ দেয়।
data.pin_grant.mailbox_id integer
শর্তসাপেক্ষে রিড গ্রান্ট যেটিতে বাঁধা আছে সেই মেলবক্স আইডি।
data.pin_grant.unlock_token string
একই মালিকের ক্রেডেনশিয়াল সহ X-Mailbox-Unlock এর জন্য অস্বচ্ছ রিড টোকেন। এটি ব্যক্তিগতভাবে এবং মেমরিতে রাখুন; একটি রিড গ্র্যান্ট মুছে ফেলার অনুমোদন দেয় না।
data.pin_grant.scope string
শর্তসাপেক্ষ সৃষ্টির অনুদানের জন্য স্কোপটি পড়া হয়েছে।
data.pin_grant.idle_timeout_seconds integer
রিড গ্রান্টের জন্য অনুমোদিত নিষ্ক্রিয় সময়, সাধারণত ৩৬০০ সেকেন্ড।
data.pin_grant.absolute_timeout_seconds integer
রিড গ্রান্টের সর্বোচ্চ আয়ু, সাধারণত 86400 সেকেন্ড।
data.pin_grant.expires_at string
ISO-8601 ফরম্যাটে বর্তমান রিড-গ্রান্টের মেয়াদ শেষ।
data.pin_grant.absolute_expires_at string
ISO-8601 ফরম্যাটে সম্পূর্ণ রিড-গ্রান্টের মেয়াদ শেষ। নিরাপত্তা পরিবর্তনগুলি গ্রান্টটি আগে বাতিল করতে পারে।

মেসেজ ও সংযুক্তি

ইনকামিং ইনবক্সগুলি আনুন, পূর্ণ HTML/টেক্সট বার্তা পড়ুন, এবং সংযুক্তিগুলি স্ট্রিম করুন।

GET https://v1.tempmailg.com/api/messages?email={email}
#

মেলবক্সের বার্তা তালিকা

উপলব্ধ বার্তা সংক্ষিপ্তসার এবং মেইলবক্স মেটাডেটা পুনরুদ্ধার করুন। স্ট্যান্ডার্ড ইনবক্স স্ক্যানগুলি সর্বশেষ ২৫টি বার্তা পর্যন্ত একটি ব্যাচ ফেরত দেয়; এটি পেজিনেটেড পূর্ণ-ইতিহাস এন্ডপয়েন্ট নয়। পূর্ণ বডি এবং সংযুক্তির জন্য GET /messages/{messageId} ব্যবহার করুন।

প্যারামিটার 2
প্যারামিটার অবস্থান ১৩. ধরন স্থিতি ২২. বিবরণ
email query string প্রয়োজনীয়
মেসেজ পড়ার জন্য মালিকানাধীন মেলবক্সের পূর্ণ ইমেইল ঠিকানা। কুয়েরি মানটি URL-এনকোড করুন; প্লাস চিহ্নকে %2B হিসেবে এনকোড করুন।
X-Mailbox-Unlock header string ঐচ্ছিক
শিরোনাম, শুধুমাত্র সুরক্ষিত মেলবক্স: একটি রিড unlock_token ব্যবহার করুন। প্রথমে PIN এবং scope=read সহ POST করুন PIN unlock URL-এ। আপনার স্বাভাবিক Bearer প্রমাণীকরণ বজায় রাখুন। <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
ইমেলটি আপনার অ্যাকাউন্টের অন্তর্ভুক্ত হতে হবে। স্ট্যান্ডার্ড এবং Gmail সারাংশে OTP এবং verification-link ফিল্ড থাকে; Outlook-এ from_name, snippet, received_at এবং has_attachments ও অন্তর্ভুক্ত থাকে। প্রোভাইডার সিঙ্ক্রোনাইজেশন এবং ক্যাশিং নতুন মেসেজ এবং গণনা বিলম্বিত করতে পারে।
২২. মেইলবক্স বার্তা পড়ুন
curl --request GET \
  --url 'https://v1.tempmailg.com/api/messages?email=demo123@example.com' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

সিন্থেটিক ডেটা ব্যবহার করে উদাহরণস্বরূপ প্রতিক্রিয়া। আইডি, ঠিকানা, টোকেন, টাইমস্ট্যাম্প, পরিকল্পনা সীমা এবং গণনা পরিবর্তিত হয়। নমুনা লাইফটাইম আপনার পরিকল্পনার ডিফল্টকে অতিক্রম করে না। প্রতিক্রিয়া ফিল্ডের বিবরণ nullable এবং প্রদানকারী-নির্দিষ্ট ফিল্ডগুলি চিহ্নিত করে।

১৪. উদাহরণ প্রতিক্রিয়া
200 OK • JSON
{
    "status": true,
    "mailbox": "demo123@example.com",
    "email_token": "encrypted-email-token",
    "messages": [
        {
            "is_seen": false,
            "subject": "Welcome to Temp Mail",
            "from": "Example Sender",
            "from_email": "hello@example.org",
            "receivedAt": "2026-11-19 02:18:14",
            "id": "ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1",
            "otp": null,
            "otp_locked": false,
            "verification_link": null,
            "verification_link_locked": false
        }
    ],
    "mailbox_provider": "standard",
    "mailbox_state": "active",
    "expire_at": "2026-11-20T02:18:14+00:00",
    "expires_in_seconds": 86399.75,
    "receiving_enabled": true,
    "mailbox_limit": {
        "limit": 50,
        "limit_label": "50",
        "active_count": 1,
        "paused_count": 0,
        "paused_mailboxes": [],
        "remaining": 49,
        "remaining_label": "49",
        "reached": false,
        "blocked": false,
        "provider": "standard"
    },
    "message_count": 1,
    "unread_message_count": 1,
    "last_message_received_at": "2026-11-19T02:18:14+00:00",
    "message_count_synced_at": "2026-11-19T02:18:14+00:00"
}
প্রতিক্রিয়া ক্ষেত্রসমূহ
ক্ষেত্র ১৩. ধরন ২২. বিবরণ
status boolean
অপারেশনটি সফল হয়েছে কিনা।
mailbox string
যে মেলবক্সের ঠিকানার বার্তাগুলি অনুরোধ করা হয়েছিল।
email_token string
অস্বচ্ছ এনক্রিপ্টেড মেলবক্স রেফারেন্স; স্বাভাবিক প্রমাণীকরণ এখনও প্রয়োজন।
mailbox_provider string
মেলবক্স প্রদানকারী: standard, gmail_alias, অথবা outlook_alias।
messages array
বার্তা সংক্ষিপ্তসার। একটি খালি ইনবক্স একটি খালি অ্যারে ফেরত দেয়; তার বডি এবং সংযুক্তিগুলির জন্য একটি একক বার্তা পুনরুদ্ধার করুন।
expire_at string|null
ISO-8601 টাইমস্ট্যাম্প হিসেবে কার্যকর মেয়াদ শেষ, অথবা সীমাহীন মেলবক্সের জন্য null।
expires_in_seconds number|null
গণনা করার সময় অবশিষ্ট অ-নেতিবাচক সেকেন্ড; ভগ্নাংশ সেকেন্ডও সম্ভব। নাল মানে সীমাহীন, শূন্য নয়।
mailbox_state string
বর্তমান মেলবক্সের অবস্থা: সক্রিয়, বিরত, মেয়াদোত্তীর্ণ, অথবা নিষ্ক্রিয়।
receiving_enabled boolean
এই মেইলবক্স বর্তমানে ইনকামিং মেসেজ গ্রহণ করে কিনা।
message_count integer
পরিচিত মোট বার্তা সংখ্যা; এটি শেষ মেইলবক্স সিঙ্ক্রোনাইজেশনকে প্রতিফলিত করতে পারে।
unread_message_count integer
পরিচিত না-পড়া বার্তার সংখ্যা; এটি শেষ মেইলবক্স সিঙ্ক্রোনাইজেশনকে প্রতিফলিত করতে পারে।
last_message_received_at string|null
ISO-8601 ফরম্যাটে সর্বশেষ জানা প্রাপ্ত-বার্তার সময়, অথবা অনুপলব্ধ হলে null।
message_count_synced_at string|null
ISO-8601 ফরম্যাটে শেষ বার্তা-গণনা সিঙ্ক্রোনাইজেশন সময়, অথবা সিঙ্ক্রোনাইজেশনের আগে null।
mailbox_limit.limit integer
এই প্রদানকারীর জন্য সক্রিয় মেইলবক্স সীমা; -1 মানে সীমাহীন।
mailbox_limit.limit_label string
মেলবক্স সীমার জন্য প্রদর্শন লেবেল।
mailbox_limit.active_count integer
এই প্রদানকারীর জন্য সক্রিয় মেলবক্সের সংখ্যা।
mailbox_limit.paused_count integer
এই প্রদানকারীর জন্য স্থগিত মেলবক্সের সংখ্যা।
mailbox_limit.paused_mailboxes array<string>
মেইলবক্স সীমার কারণে ঠিকানাগুলি স্থগিত করা হয়েছে।
mailbox_limit.remaining integer
বাকি সক্রিয় মেইলবক্স স্লট; -1 মানে সীমাহীন। এটি API অনুরোধ কোটা নয়।
mailbox_limit.remaining_label string
বাকি মেলবক্স স্লটের জন্য প্রদর্শন লেবেল।
mailbox_limit.reached boolean
সক্রিয় মেলবক্স সীমা পৌঁছেছে কিনা।
mailbox_limit.blocked boolean
সক্রিয় মেলবক্স সীমা শূন্য কিনা।
mailbox_limit.provider string|null
মেলবক্স সীমা প্রযোজ্য প্রোভাইডার।
messages[].id string
একক-বার্তা, মুছে ফেলা এবং সংযুক্তি এন্ডপয়েন্টগুলিতে ব্যবহৃত অস্বচ্ছ বার্তা আইডি।
messages[].is_seen boolean
মেসেজটি কি পড়া হিসেবে চিহ্নিত হয়েছে।
messages[].subject string
বার্তার বিষয়।
messages[].from string
প্রেরকের প্রদর্শন নাম বা ঠিকানা।
messages[].from_email string
প্রেরকের ইমেইল ঠিকানা।
messages[].receivedAt string
অ্যাপ্লিকেশনের টাইমজোনে প্রাপ্ত সময়, ফরম্যাট করা হয়েছে YYYY-MM-DD HH:mm:ss হিসেবে।
messages[].otp string|null
প্রাপ্য এবং অনুমোদিত হলে একবারের কোড সনাক্ত করা হয়েছে; অন্যথায় null।
messages[].otp_locked boolean
একটি সনাক্ত করা একবারের কোড ফিচার অনুমতিগুলোর দ্বারা লুকানো কিনা।
messages[].verification_link string|null
প্রাপ্য এবং অনুমোদিত হলে সনাক্ত করা যাচাইকরণ URL; অন্যথায় null।
messages[].verification_link_locked boolean
একটি সনাক্ত করা যাচাইকরণ লিঙ্ক বৈশিষ্ট্য অনুমতিগুলির দ্বারা লুকানো আছে কিনা।
messages[].from_name string|null
Outlook সারাংশ ক্ষেত্র: মূল প্রেরকের নাম। স্ট্যান্ডার্ড এবং Gmail সারাংশে অনুপস্থিত।
messages[].snippet string|null
Outlook সারাংশ ক্ষেত্র: সংক্ষিপ্ত বার্তার প্রিভিউ।
messages[].received_at string|null
Outlook সারাংশ ক্ষেত্র: ISO-8601 প্রাপ্ত সময়, যখন জানা থাকে।
messages[].has_attachments boolean
Outlook সারাংশ ক্ষেত্র: সংযুক্তি মেটাডেটা আছে কিনা। ডাউনলোডের প্রাপ্যতা আলাদাভাবে পরীক্ষা করা হয়।
GET https://v1.tempmailg.com/api/messages/{messageId}
#

একটি একক বার্তা পান

একটি মালিকানাধীন বার্তা তার অস্বচ্ছ বার্তা আইডি দ্বারা পুনরুদ্ধার করুন। বডি ফরম্যাট এবং সংযুক্তি মেটাডেটা ফেরত দেয়। বডি ফিল্ডগুলি বার্তার ফরম্যাটের উপর নির্ভরশীল; Outlook নিচে তালিকাভুক্ত প্রদানকারী-নির্দিষ্ট ফিল্ডগুলি যোগ করে।

প্যারামিটার 2
প্যারামিটার অবস্থান ১৩. ধরন স্থিতি ২২. বিবরণ
messageId path string প্রয়োজনীয়
বার্তা তালিকায় ফেরত দেওয়া অনন্য বার্তা আইডি।
X-Mailbox-Unlock header string ঐচ্ছিক
শিরোনাম, শুধুমাত্র সুরক্ষিত মেলবক্স: একটি রিড unlock_token ব্যবহার করুন। প্রথমে PIN এবং scope=read সহ POST করুন PIN unlock URL-এ। আপনার স্বাভাবিক Bearer প্রমাণীকরণ বজায় রাখুন। <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
২৪. একটি বার্তা পড়ুন
curl --request GET \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

সিন্থেটিক ডেটা ব্যবহার করে উদাহরণস্বরূপ প্রতিক্রিয়া। আইডি, ঠিকানা, টোকেন, টাইমস্ট্যাম্প, পরিকল্পনা সীমা এবং গণনা পরিবর্তিত হয়। নমুনা লাইফটাইম আপনার পরিকল্পনার ডিফল্টকে অতিক্রম করে না। প্রতিক্রিয়া ফিল্ডের বিবরণ nullable এবং প্রদানকারী-নির্দিষ্ট ফিল্ডগুলি চিহ্নিত করে।

১৪. উদাহরণ প্রতিক্রিয়া
200 OK • JSON
{
    "status": true,
    "data": {
        "is_seen": true,
        "subject": "Welcome to Temp Mail",
        "from": "Example Sender",
        "from_email": "hello@example.org",
        "to": "demo123@example.com",
        "mailbox_provider": "standard",
        "receivedAt": "2026-11-19 02:18:14",
        "id": "ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1",
        "html": true,
        "html_content": "<p>Hello from the inbox.</p>",
        "text_content": "<pre>Hello from the inbox.</pre>",
        "content": "<p>Hello from the inbox.</p>",
        "attachments": [
            {
                "name": "file.txt",
                "extension": "txt",
                "size": 91,
                "url": "https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt"
            }
        ]
    }
}
প্রতিক্রিয়া ক্ষেত্রসমূহ
ক্ষেত্র ১৩. ধরন ২২. বিবরণ
status boolean
অপারেশনটি সফল হয়েছে কিনা।
data.id string
অস্বচ্ছ বার্তা আইডি।
data.is_seen boolean
বার্তার পাঠের অবস্থা। পাঠ করা এটিকে দেখা হয়েছে হিসেবে চিহ্নিত করতে পারে; ক্যাশ করা ডেটা পূর্বের অবস্থা প্রতিফলিত করতে পারে।
data.subject string
বার্তার বিষয়।
data.from string
প্রেরকের প্রদর্শন নাম বা ঠিকানা।
data.from_email string
প্রেরকের ইমেইল ঠিকানা।
data.to string
প্রাপকের মেলবক্স ঠিকানা।
data.mailbox_provider string
মেলবক্স প্রদানকারী: standard, gmail_alias, অথবা outlook_alias।
data.receivedAt string
অ্যাপ্লিকেশনের টাইমজোনে প্রাপ্ত সময়, ফরম্যাট করা হয়েছে YYYY-MM-DD HH:mm:ss হিসেবে।
data.html boolean
মেসেজের HTML বডি আছে কি না।
data.html_content string
উপস্থিত থাকলে HTML বডি। HTML ছাড়া স্ট্যান্ডার্ড মেসেজগুলি এই ফিল্ডটি বাদ দিতে পারে। মেসেজের বিষয়বস্তুকে অবিশ্বস্ত হিসেবে বিবেচনা করুন।
data.text_content string
উপস্থিত থাকলে টেক্সট বডি; স্ট্যান্ডার্ড মেসেজগুলো প্রি উপাদানে এস্কেপ করা টেক্সট ধারণ করতে পারে অথবা এই ফিল্ডটি বাদ দিতে পারে।
data.content string
প্রদর্শনের জন্য পছন্দসই বডি, সাধারণত উপলব্ধ থাকলে HTML।
data.attachments array
সংযুক্তির মেটাডেটা, অথবা একটি খালি অ্যারে। ডাউনলোডের জন্য সাধারণ প্রমাণীকরণ এবং প্রযোজ্য PIN অনুমোদন প্রয়োজন।
data.attachments[].name string
ডাউনলোডের সময় একক পথ সেগমেন্ট হিসাবে ফাইলনামকে URL-এনকোড করুন।
data.attachments[].size integer
সংযুক্তির আকার বাইটে।
data.attachments[].url string
একটি ফাইলের নাম সহ সংযুক্তিগুলিতে প্রমাণীকৃত ব্যবহারকারী API ডাউনলোড URL যোগ করা হয়েছে। একটি URL গ্যারান্টি দেয় না যে স্থানীয় ফাইলটি উপলব্ধ।
data.attachments[].extension string
স্ট্যান্ডার্ড/জিমেইল মেটাডেটা ফিল্ড: সরবরাহ করা হলে ফাইল এক্সটেনশন।
data.attachments[].id string
Outlook মেটাডেটা ফিল্ড: প্রদানকারী সংযুক্তি আইডি।
data.attachments[].content_type string
Outlook মেটাডেটা ক্ষেত্র: MIME কন্টেন্ট টাইপ।
data.from_name string|null
Outlook বিশদ ক্ষেত্র: মূল প্রেরকের নাম।
data.to_email string|null
Outlook বিশদ ক্ষেত্র: মূল প্রাপক ঠিকানা।
data.received_at string|null
Outlook বিশদ ক্ষেত্র: ISO-8601 প্রাপ্ত সময়।
data.has_html boolean
Outlook বিশদ ক্ষেত্র: একটি HTML বডি আছে কি না।
DELETE https://v1.tempmailg.com/api/messages/{messageId}
#

বার্তা মুছুন

২৫. একটি একক মালিকানাধীন বার্তা মুছে ফেলুন।

প্যারামিটার 3
প্যারামিটার অবস্থান ১৩. ধরন স্থিতি ২২. বিবরণ
messageId path string প্রয়োজনীয়
স্থায়ীভাবে মুছে ফেলার জন্য অনন্য বার্তা আইডি স্ট্রিং।
X-Mailbox-Unlock header string ঐচ্ছিক
শিরোনাম, শুধুমাত্র সুরক্ষিত মেইলবক্স: একবার ব্যবহারযোগ্য ডিলিট unlock_token ব্যবহার করুন। প্রথমে POST pin, scope=delete এবং 423 প্রতিক্রিয়া থেকে প্রাপ্ত action/target_id PIN unlock URL-এ। একটি রিড টোকেন ডিলিট করতে পারে না। <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Idempotency-Key header string ঐচ্ছিক
PIN-সুরক্ষিত সৃষ্টিকরণ বা মুছে ফেলার জন্য প্রয়োজন: একটি স্থিতিশীল 16 থেকে 128 অক্ষরের কী। একই কী দিয়ে একই অনুরোধ পুনরায় চেষ্টা করুন যাতে ডুপ্লিকেট কাজ এড়ানো যায়।
১. একটি বার্তা মুছে ফেলুন
curl --request DELETE \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

সিন্থেটিক ডেটা ব্যবহার করে উদাহরণস্বরূপ প্রতিক্রিয়া। আইডি, ঠিকানা, টোকেন, টাইমস্ট্যাম্প, পরিকল্পনা সীমা এবং গণনা পরিবর্তিত হয়। নমুনা লাইফটাইম আপনার পরিকল্পনার ডিফল্টকে অতিক্রম করে না। প্রতিক্রিয়া ফিল্ডের বিবরণ nullable এবং প্রদানকারী-নির্দিষ্ট ফিল্ডগুলি চিহ্নিত করে।

১৪. উদাহরণ প্রতিক্রিয়া
200 OK • JSON
{
    "status": true,
    "message": "Message was deleted successfully."
}
প্রতিক্রিয়া ক্ষেত্রসমূহ
ক্ষেত্র ১৩. ধরন ২২. বিবরণ
status boolean
অপারেশনটি সফল হয়েছে কিনা।
message string
মুছে ফেলার ফলাফল। একটি অনুপস্থিত রিসোর্স HTTP 404 রিটার্ন করে।
GET https://v1.tempmailg.com/api/messages/{messageId}/attachments/{filename}
#

সংযুক্তি ডাউনলোড করুন

২. একটি মালিকানাধীন বার্তা থেকে একটি অ্যাটাচমেন্ট ডাউনলোড করুন।

প্যারামিটার 3
প্যারামিটার অবস্থান ১৩. ধরন স্থিতি ২২. বিবরণ
messageId path string প্রয়োজনীয়
ফাইল ধারণকারী বার্তার আইডি।
filename path string প্রয়োজনীয়
ডাউনলোড করার জন্য সংযুক্তির ফাইলনাম এবং এক্সটেনশন।
X-Mailbox-Unlock header string ঐচ্ছিক
শিরোনাম, শুধুমাত্র সুরক্ষিত মেলবক্স: একটি রিড unlock_token ব্যবহার করুন। প্রথমে PIN এবং scope=read সহ POST করুন PIN unlock URL-এ। আপনার স্বাভাবিক Bearer প্রমাণীকরণ বজায় রাখুন। <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
সফল হলে ফাইল বাইটস রিটার্ন হয়, JSON নয়। অতিরিক্ত বড় ফাইলগুলি HTTP 403 রিটার্ন করে; অনুপস্থিত বা অপ্রাপ্য স্থানীয় ফাইলগুলি HTTP 404 রিটার্ন করে। ফাইলনামকে একক পাথ সেগমেন্ট হিসেবে URL-এনকোড করুন। সংযুক্তি মেটাডেটা একা ডাউনলোডের প্রাপ্যতা নিশ্চিত করে না।
৪. একটি অ্যাটাচমেন্ট ডাউনলোড করুন
curl --request GET \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY' \
  --output file.txt
১৮. ডাউনলোড আচরণ ১৯. এই এনডপয়েন্টটি একটি JSON বডির পরিবর্তে অনুরোধ করা ফাইলটি সরাসরি প্রদান করে।
প্রতিক্রিয়া ক্ষেত্রসমূহ
ক্ষেত্র ১৩. ধরন ২২. বিবরণ
Content-Disposition header
সফল প্রতিক্রিয়া অনুরোধকৃত ফাইলনাম ডাউনলোড করে।
body binary
সফল হলে ফাইল বাইটস, JSON নয়। ত্রুটি হলে অ-২xx স্ট্যাটাস সহ JSON রিটার্ন করে।

হার সীমা ও কোটা

ক্রেডিট ব্যবহার না করে রিয়েল-টাইম রিকোয়েস্ট বাজেট, রেট লিমিট এবং অ্যাকাউন্ট কোটা মনিটর করুন।

GET https://v1.tempmailg.com/api/rate-limit
#

রেট লিমিট ও কোটা

আপনার বর্তমান রেট লিমিট এবং কোটা স্ট্যাটাস কোনো API ব্যবহার না করে পরীক্ষা করুন। এই এন্ডপয়েন্টটি কোটা-ফ্রি এবং মাসিক API ক্রেডিট কেটে না (অপব্যবহার সুরক্ষা সীমা: 60 রিকোয়েস্ট/মিনিট)।

X-RateLimit-* নির্দেশিত অনুরোধ বাজেট বর্ণনা করে; X-Quota-* উপলব্ধ হলে মাসিক এবং ক্রয়কৃত ক্ষমতা বর্ণনা করে। X-Mailbox-RateLimit-* পৃথক মেলবক্স তৈরি/আপডেট বাজেট রিপোর্ট করে। একটি মেলবক্স-শুধু প্রত্যাখ্যান মেলবক্স স্কোপ এবং তার নিজস্ব রিট্রাই উইন্ডো ব্যবহার করে। মিনিট-লিমিট প্রত্যাখ্যানগুলি কোটা তথ্য বাদ দিতে পারে। Retry-After শুধুমাত্র সময় নির্ধারিত রিট্রাইয়ের জন্য অন্তর্ভুক্ত হয়; নিষ্ক্রিয় অ্যাক্সেসের জন্য একটি অ্যাকাউন্ট পরিবর্তন প্রয়োজন হতে পারে। এই সফল স্ট্যাটাস রেসপন্সে, data.limit, data.remaining এবং data.reset অ্যাকাউন্টের মিনিট বাজেট বর্ণনা করে, ব্যয়যোগ্য ক্রেডিট নয়। data.quota অবজেক্ট মাসিক ভাতা, ক্রেডিট ব্যালেন্স এবং ব্যবহার বর্ণনা করে। বিদ্যমান data.monthly_limit, data.monthly_remaining এবং data.purchased_credits ফিল্ডগুলি সংশ্লিষ্ট কোটার ফিল্ডগুলোর উপনাম হিসেবে রয়ে যায়। একটি সফল স্ট্যাটাস চেক অন্য কোনো API অপারেশনকে অনুমোদন করে না। অপারেশনগুলির জন্য এখনও সক্রিয় অ্যাক্সেস, উপলব্ধ কোটা এবং সমস্ত প্রযোজ্য সীমার মাধ্যমে অনুমোদন প্রয়োজন। কোটা স্ন্যাপশট ইতিমধ্যে চলমান অনুরোধ দ্বারা সংরক্ষিত ক্ষমতা নিশ্চিত করে না।
রেট লিমিট স্ট্যাটাস পরীক্ষা করুন
curl --request GET \
  --url 'https://v1.tempmailg.com/api/rate-limit' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

সিন্থেটিক ডেটা ব্যবহার করে উদাহরণস্বরূপ প্রতিক্রিয়া। আইডি, ঠিকানা, টোকেন, টাইমস্ট্যাম্প, পরিকল্পনা সীমা এবং গণনা পরিবর্তিত হয়। নমুনা লাইফটাইম আপনার পরিকল্পনার ডিফল্টকে অতিক্রম করে না। প্রতিক্রিয়া ফিল্ডের বিবরণ nullable এবং প্রদানকারী-নির্দিষ্ট ফিল্ডগুলি চিহ্নিত করে।

১৪. উদাহরণ প্রতিক্রিয়া
200 OK • JSON
{
    "status": "success",
    "data": {
        "limit": 60,
        "remaining": 45,
        "reset": 32,
        "plan": "premium",
        "monthly_limit": 50000,
        "monthly_remaining": 48210,
        "purchased_credits": 5000,
        "quota": {
            "enabled": true,
            "user_api_status": true,
            "plan_name": "Premium Plan",
            "period": "2026-10",
            "base_limit": 50000,
            "extra_requests": 0,
            "monthly_limit": 50000,
            "monthly_remaining": 48210,
            "used": 1790,
            "purchased_credits": 5000,
            "bonus_credits": 1000,
            "direct_purchased_credits": 4000,
            "remaining": 53210,
            "unlimited": false,
            "usage_percent": 3,
            "reset_at": "2026-11-01T00:00:00+00:00"
        }
    }
}
প্রতিক্রিয়া ক্ষেত্রসমূহ
ক্ষেত্র ১৩. ধরন ২২. বিবরণ
data.limit integer|string
অ্যাকাউন্ট অনুরোধ-প্রতি-মিনিট সীমা। স্ট্রিং unlimited একটি অসীম মিনিট বাজেট নির্দেশ করে; এটি মাসিক কোটা থেকে স্বাধীন।
data.remaining integer|string
অবশিষ্ট অ্যাকাউন্ট মিনিট-বাজেট স্লট, অথবা স্ট্রিং unlimited। একটি ধনাত্মক মান মানে নয় যে API ক্রেডিট অবশিষ্ট আছে।
data.reset integer
অ্যাকাউন্টের মিনিট উইন্ডোর জন্য সেকেন্ড, মাসিক কোটা রিসেটের জন্য নয়। নিষ্ক্রিয় বা অসীম মিনিট বাজেটগুলি একটি নামমাত্র 60-সেকেন্ড মান বজায় রাখতে পারে; এটি অপেক্ষা করার পরে প্রবেশের প্রতিশ্রুতি দেয় না।
data.plan string
বর্তমান পরিকল্পনা ট্যাগ। পাঠযোগ্য পরিকল্পনা নামটি আলাদাভাবে data.quota.plan_name-এ প্রদান করা হয়েছে।
data.quota.enabled boolean
গ্লোবাল এবং পরিকল্পনা/ক্রেডিট API অ্যাক্সেস সক্রিয় কিনা। এটি অবশিষ্ট ক্ষমতা নির্দেশ করে না বা ব্যবহারকারী API সুইচের পরিবর্তে নয়।
data.quota.user_api_status boolean
ব্যবহারকারী তাদের ইউজার API সুইচ সক্রিয় করেছেন কিনা। অপারেশনগুলির জন্য এই সুইচ এবং সক্রিয় অ্যাক্সেস ও উপলব্ধ ক্ষমতা প্রয়োজন।
data.quota.plan_name string
বর্তমান পরিকল্পনার পাঠযোগ্য নাম।
data.quota.period string
ক্যালেন্ডার-মাসের ব্যবহার সময়কাল YYYY-MM ফরম্যাটে, অ্যাপ্লিকেশন টাইমজোন ব্যবহার করে; অবশ্যই সাবস্ক্রিপশন বিলিং সময়কাল নয়।
data.quota.base_limit integer
মৌলিক মাসিক পরিকল্পনা ভাতা। -১ মানের অর্থ সীমাহীন।
data.quota.extra_requests integer
বর্তমান ব্যবহার সময়ের জন্য অতিরিক্ত মাসিক ভাতা প্রদান করা হয়েছে; ক্রয় করা ক্রেডিট থেকে আলাদা।
data.quota.monthly_limit integer
বেস ভাতা প্লাস বর্তমান-পর্যায়ের অতিরিক্ত অনুরোধ। -1 মানে সীমাহীন। ক্রয় করা ক্রেডিট অন্তর্ভুক্ত নয়।
data.quota.monthly_remaining integer|null
অবশিষ্ট সীমিত মাসিক ভাতা, অথবা যখন মাসিক কোটা সীমাহীন হয় তখন null। Null-কে শূন্য হিসেবে ব্যাখ্যা করা উচিত নয়।
data.quota.used integer
সফল, বর্তমান ব্যবহার সময়কালে গণনা করা API অপারেশন, ক্রেডিট ব্যবহার করে করা অপারেশনসহ। স্ট্যাটাস চেকগুলি এই মান বৃদ্ধি করে না।
data.quota.purchased_credits integer
বর্তমান ক্রেডিট ব্যালেন্স, সক্রিয় পরিকল্পনার বোনাস ক্রেডিটসহ। বোনাস ক্রেডিটগুলি এই ব্যালেন্সে দ্বিতীয়বার যোগ করা উচিত নয়।
data.quota.bonus_credits integer
ক্রেডিট ব্যালেন্সের সক্রিয় পরিকল্পনা-বোনাস অংশ; ক্রয়কৃত_ক্রেডিটের বিশ্লেষণ, অতিরিক্ত ক্ষমতা নয়।
data.quota.direct_purchased_credits integer
সক্রিয় পরিকল্পনা-বোনাস অংশ বাদে ক্রেডিট ব্যালেন্স। এই মানের সাথে bonus_credits যোগ করলে purchased_credits হয়।
data.quota.remaining integer|null
মাসিক অবশিষ্ট ভাতা এবং বর্তমান ক্রেডিট ব্যালেন্স, বোনাস দ্বিগুণ গণনা না করে। Null মানে অসীম মাসিক কোটা। পৃথক ফিচার অনুমতি এবং অন্যান্য অনুরোধ সীমা এখনও প্রযোজ্য।
data.quota.unlimited boolean
মাসিক কোটা সীমাহীন কিনা। এটি অ্যাকাউন্টের মিনিট বাজেট বা অন্যান্য ফিচার সীমা সীমাহীন করে না।
data.quota.usage_percent integer
ড্যাশবোর্ড-সামঞ্জস্যপূর্ণ ০ থেকে ১০০ পর্যন্ত রাউন্ডেড শতাংশ: ব্যবহৃত ভাগ করা হয় ব্যবহৃত প্লাস অবশিষ্ট দিয়ে, তারপর ১০০ দিয়ে গুণ করা হয়। এতে উপলব্ধ ক্রেডিট ক্ষমতা অন্তর্ভুক্ত থাকে, তাই রিচার্জ করলে শতাংশ কমে যেতে পারে। এটি অনির্দিষ্ট কোটা বা শূন্য-আকারের পুলের জন্য ০; এটি মিনিট রেট-লিমিট শতাংশ বা কোনো অ্যাক্সেস সিদ্ধান্ত নয়।
data.quota.reset_at string
পরবর্তী ক্যালেন্ডার-মাসের কোটা রিসেটের জন্য টাইমজোন অফসেট সহ ISO-8601 টাইমস্ট্যাম্প। এটি সাবস্ক্রিপশন মেয়াদ শেষের তারিখ নয়, এবং মাসিক রিসেট কেনা ক্রেডিট পুনরায় পূরণ করে না।
status string
এই স্ট্যাটাস এন্ডপয়েন্টের জন্য সরাসরি সফলতা। অন্যান্য সফল মেলবক্স এন্ডপয়েন্টগুলি বুলিয়ান true ব্যবহার করে।
data.monthly_limit integer
সংশ্লিষ্ট data.quota ফিল্ডের সামঞ্জস্যতা উপনাম; ব্যালেন্স গণনা করার সময় এটি আবার যোগ করবেন না।
data.monthly_remaining integer|null
সংশ্লিষ্ট data.quota ফিল্ডের সামঞ্জস্যতা উপনাম; ব্যালেন্স গণনা করার সময় এটি আবার যোগ করবেন না।
data.purchased_credits integer
সংশ্লিষ্ট data.quota ফিল্ডের সামঞ্জস্যতা উপনাম; ব্যালেন্স গণনা করার সময় এটি আবার যোগ করবেন না।

মেইলবক্স পিন সুরক্ষা

চালিয়ে যেতে PIN প্রবেশ করুন। আপনার মেলবক্স এই ওয়েবসাইট সেশনে বর্তমান থাকাকালীন আনলক থাকে।

আপনি কি কুকি গ্রহণ করেন?

আমরা আপনার ব্রাউজিং অভিজ্ঞতা উন্নত করতে কুকিজ ব্যবহার করি। এই সাইটটি ব্যবহার করে, আপনি আমাদের কুকি নীতিতে সম্মতি দেন।

বেশি