২১. দ্রুত সেটআপ চেকলিস্ট
- ২২. আপনার ড্যাশবোর্ড API ম্যানেজমেন্ট পৃষ্ঠা খুলুন এবং আপনার ব্যক্তিগত API কী তৈরি করুন।
- ২৩. সেখানে দেখানো সঠিক ব্যবহারকারী API বেস ইউআরএল কপি করুন, উদাহরণস্বরূপ https://v1.tempmailg.com/api.
- ২৪. সমস্ত অনুরোধ সেই API হোস্টে পাঠান Authorization: Bearer YOUR_USER_API_KEY ২৫. এবং Accept: application/json.
- একই ড্যাশবোর্ড পৃষ্ঠা থেকে এবং ব্যবহারকারী API প্রতিক্রিয়ায় যখন উপলব্ধ থাকে তখন কোটা হেডার থেকে আপনার মাসিক অনুরোধ কোটা ট্র্যাক করুন। শুধুমাত্র সফল 2xx অনুরোধগুলি কোটা গণনায় অন্তর্ভুক্ত হয়।
৬. প্রমাণীকরণ প্রবাহ
- ৭. ড্যাশবোর্ড API ম্যানেজমেন্ট পৃষ্ঠা থেকে আপনার ব্যক্তিগত API কী তৈরি করুন।
- ৮. প্রতিটি অনুরোধে একটি বেয়ারার টোকেন হিসাবে কী পাঠান।
- ৯. আপনার API ম্যানেজমেন্ট পৃষ্ঠায় দেখানো ডিডিকেটেড ইউজার API বেস ইউআরএল ব্যবহার করুন।
- ১০. পুরানোটি বাতিল করতে এবং অবিলম্বে একটি নতুন কী ব্যবহার শুরু করতে যেকোনো সময় কী পুনরুত্পাদন করুন।
১৩. প্রয়োজনীয় হেডার
Authorization: Bearer YOUR_USER_API_KEY
Accept: application/json
রেট লিমিট এবং কোটা হেডারস
রেট-লিমিট হেডারগুলি নির্দেশিত অনুরোধ বাজেট বর্ণনা করে। কোটা হেডারগুলি অন্তর্ভুক্ত করা হয় যখন কোটা তথ্য উপলব্ধ থাকে; মিনিট-লিমিট প্রত্যাখ্যানগুলি আপনার পূর্ণ মাসিক কোটা গণনা করে না।
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1729520000
X-Quota-Limit: 50000
X-Quota-Remaining: 48210
X-Quota-Used: 1790
X-Quota-Reset: 2026-11-01T00:00:00+00:00
X-RateLimit-Scope: account
Retry-After: 42 (when a timed retry is available)
X-RateLimit-Limit— আপনার পরিকল্পনার জন্য প্রতি মিনিটে অনুমোদিত সর্বোচ্চ অনুরোধ (RPM)।X-RateLimit-Remaining— বর্তমান মিনিট উইন্ডোতে অবশিষ্ট RPM অনুরোধ।X-RateLimit-Reset— বর্তমান মিনিট রেট লিমিট উইন্ডো রিসেট হওয়ার সময়ের ইউনিক্স টাইমস্ট্যাম্প।X-Quota-Limit— আপনার অ্যাকাউন্টের মোট মাসিক এবং ক্রয় করা ক্রেডিট ক্ষমতা।X-Quota-Remaining— বর্তমান মাসে অবশিষ্ট উপলব্ধ API অনুরোধগুলি।X-Quota-Used— বর্তমান বিলিং সময়কালে ব্যবহৃত মোট API অনুরোধ।X-Quota-Reset— আপনার মাসিক কোটা রিসেট হওয়ার সময়ের ISO-8601 টাইমস্ট্যাম্প।X-RateLimit-Scope— হেডারগুলি দ্বারা বর্ণিত বাজেট: account, ip, status_endpoint, অথবা mailbox।X-Mailbox-RateLimit-*— বিচ্ছিন্ন মেলবক্স তৈরি/আপডেট বাজেট। সফল মেলবক্স প্রতিক্রিয়াগুলি X-RateLimit-* এ অ্যাকাউন্টের RPM বজায় রাখে; একটি মেলবক্স-শুধু প্রত্যাখ্যান মেলবক্স স্কোপ এবং তার নিজস্ব রিট্রাই উইন্ডো ব্যবহার করে।Retry-After— একটি সময় নির্ধারিত পুনরায় চেষ্টা উপযুক্ত হওয়া পর্যন্ত সেকেন্ড। একটি নিষ্ক্রিয় পরিকল্পনা বা শেষ হয়ে যাওয়া কোটা পরিবর্তে একটি অ্যাকাউন্ট পরিবর্তন প্রয়োজন হতে পারে, তাই এই হেডারটি সবসময় উপস্থিত থাকে না।503 protection_unavailable— API সুরক্ষা সংরক্ষণ বা সমন্বয় সাময়িকভাবে উপলব্ধ নয়। পরে পুনরায় চেষ্টা করুন; এটি কোনো পেমেন্ট ব্যর্থতা বা ক্রেডিট ডেবিট নয়।
মেইলবক্স ব্যবস্থাপনা
অনুমোদিত ডোমেইনগুলি আনুন, মেলবক্স তৈরি বা পরিবর্তন করুন, অনুমোদিত জীবদ্দশা নির্বাচন করুন, এবং মালিকানাধীন ঠিকানাগুলি মুছে ফেলুন।
অনুমোদিত ডোমেইনগুলির তালিকা
অস্থায়ী ইমেইল তৈরি করার জন্য উপলব্ধ ডোমেইনগুলির তালিকা দেখুন। আপনার সাবস্ক্রিপশন পরিকল্পনা দ্বারা সমর্থিত শুধুমাত্র ফ্রি, প্রিমিয়াম, অথবা কাস্টম ডোমেইন দেখতে টাইপ অনুযায়ী ফিল্টার করুন।
| প্যারামিটার | অবস্থান | ১৩. ধরন | স্থিতি | ২২. বিবরণ |
|---|---|---|---|---|
type
|
query | string | ঐচ্ছিক |
ডোমেইন স্তর ফিল্টার। বাদ দিলে সব ব্যবহার হয় যখন প্রিমিয়াম-ডোমেইন অ্যাক্সেস সক্রিয় থাকে, অন্যথায় ফ্রি। স্বীকৃত মানগুলি: free, basic, pro, premium, custom, ultimate, all
ডিফল্ট:
অ্যাকাউন্ট-নির্ভরশীল
|
const response = await fetch('https://v1.tempmailg.com/api/domains?type=free', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/domains?type=free', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/domains?type=free');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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 | এটি একটি কাস্টম ডোমেইন কিনা। |
অস্থায়ী মেলবক্স তৈরি করুন
একটি মালিকানাধীন অস্থায়ী মেইলবক্স তৈরি করুন। র্যান্ডম জেনারেশনের জন্য ব্যবহারকারীর নাম এবং ডোমেইন বাদ দিন, অথবা অনুমোদিত কাস্টম ব্যবহারকারীর নাম এবং অনুমোদিত ডোমেইন সরবরাহ করুন। প্রোভাইডার প্যারামিটারটি Gmail বা Outlook উপনাম জেনারেশন নির্বাচন করতে পারে।
| প্যারামিটার | অবস্থান | ১৩. ধরন | স্থিতি | ২২. বিবরণ |
|---|---|---|---|---|
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 রিটার্ন করে।const response = await fetch('https://v1.tempmailg.com/api/emails', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.post('https://v1.tempmailg.com/api/emails', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/emails');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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 ফরম্যাটে সম্পূর্ণ রিড-গ্রান্টের মেয়াদ শেষ। নিরাপত্তা পরিবর্তনগুলি গ্রান্টটি আগে বাতিল করতে পারে। |
আপডেট / মেলবক্স পরিবর্তন
বর্তমান মেইলবক্সের মালিকানা যাচাই করার পরে নতুন ব্যবহারকারীর নাম এবং ডোমেইনে একটি মেইলবক্স তৈরি করুন বা নির্বাচন করুন। এটি পুরোনো মেইলবক্সের নাম পরিবর্তন করে না বা তার আয়ু স্থানে পরিবর্তন করে না। যখন গন্তব্য ভিন্ন হয়, পুরোনো মেইলবক্স ইতিহাসে থাকে এবং সক্রিয়-মেইলবক্স সীমা দ্বারা স্থগিত হতে পারে। আপনার নিজস্ব সক্রিয় গন্তব্য পুনরায় ব্যবহার করলে তার অনুরোধকৃত আয়ু বা পরিকল্পনার ডিফল্ট পুনরায় প্রয়োগ হয়।
| প্যারামিটার | অবস্থান | ১৩. ধরন | স্থিতি | ২২. বিবরণ |
|---|---|---|---|---|
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>
|
lifetime (অনুমোদিত মান: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited)। লাইফটাইম বাদ দিন, অথবা এটি ফাঁকা রাখুন, যাতে আপনার বর্তমান মাসিক/বার্ষিক পরিকল্পনার জন্য কনফিগার করা ডিফল্ট ইমেইল লাইফটাইম ব্যবহার করা যায়। ডিফল্টটি ওভাররাইড করতে 1h এর মতো অনুমোদিত লাইফটাইম পাঠান। অনলিমিটেড কেবল তখনই ব্যবহার করা হয় যখন এটি পরিকল্পনার ডিফল্ট হিসেবে কনফিগার করা থাকে অথবা স্পষ্টভাবে অনুরোধ করা এবং অনুমোদিত হয়। বডি প্যারামিটারগুলো mailbox_lifetime এবং email_lifetime ও গ্রহণযোগ্য; প্রথম অ-খালি মান এই ক্রমে জয়ী হয়: lifetime, mailbox_lifetime, email_lifetime। অবৈধ বা নিষিদ্ধ মানগুলো ডিফল্ট স্বয়ংক্রিয়ভাবে নির্বাচন করার পরিবর্তে HTTP 422 রিটার্ন করে।const response = await fetch('https://v1.tempmailg.com/api/emails/current@example.com/demo123/example.com', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.post('https://v1.tempmailg.com/api/emails/current@example.com/demo123/example.com', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/emails/current@example.com/demo123/example.com');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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 ফরম্যাটে সম্পূর্ণ রিড-গ্রান্টের মেয়াদ শেষ। নিরাপত্তা পরিবর্তনগুলি গ্রান্টটি আগে বাতিল করতে পারে। |
মেলবক্স মুছে ফেলুন
একটি মালিকানাধীন মেইলবক্স মুছে ফেলুন এবং তার বার্তা ও ফাইল পরিষ্কার করুন। সংরক্ষিত মেইলবক্স রেকর্ডগুলি অভ্যন্তরীণভাবে সফট-ডিলিট করা হতে পারে; ঠিকানাটি আর API মাধ্যমে ব্যবহারযোগ্য নয়।
| প্যারামিটার | অবস্থান | ১৩. ধরন | স্থিতি | ২২. বিবরণ |
|---|---|---|---|---|
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 অক্ষরের কী। একই কী দিয়ে একই অনুরোধ পুনরায় চেষ্টা করুন যাতে ডুপ্লিকেট কাজ এড়ানো যায়।
|
const response = await fetch('https://v1.tempmailg.com/api/emails/demo123@example.com', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.delete('https://v1.tempmailg.com/api/emails/demo123@example.com', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/emails/demo123@example.com');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'DELETE',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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 উপনাম মেলবক্স তৈরি করুন।
Gmail উপনাম তৈরি করুন
প্রমাণিত ব্যবহারকারীর মালিকানাধীন একটি নতুন Gmail উপনাম অস্থায়ী মেইলবক্স তৈরি করুন।
| প্যারামিটার | অবস্থান | ১৩. ধরন | স্থিতি | ২২. বিবরণ |
|---|---|---|---|---|
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 অক্ষরের কী। একই কী দিয়ে একই অনুরোধ পুনরায় চেষ্টা করুন যাতে ডুপ্লিকেট কাজ এড়ানো যায়।
|
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 রিটার্ন করে।const response = await fetch('https://v1.tempmailg.com/api/gmail-alias/emails', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.post('https://v1.tempmailg.com/api/gmail-alias/emails', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/gmail-alias/emails');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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 ফরম্যাটে সম্পূর্ণ রিড-গ্রান্টের মেয়াদ শেষ। নিরাপত্তা পরিবর্তনগুলি গ্রান্টটি আগে বাতিল করতে পারে। |
Outlook উপনাম ডোমেইন
মেইলবক্স জেনারেশনের জন্য উপলব্ধ সক্রিয় Outlook / Hotmail উপনাম ডোমেইনগুলি সংগ্রহ করুন।
const response = await fetch('https://v1.tempmailg.com/api/outlook-alias/domains', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/outlook-alias/domains', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/outlook-alias/domains');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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। |
Outlook উপনাম তৈরি করুন
প্রমাণিত ব্যবহারকারীর মালিকানাধীন একটি নতুন Outlook / Hotmail উপনাম অস্থায়ী মেইলবক্স তৈরি করুন।
| প্যারামিটার | অবস্থান | ১৩. ধরন | স্থিতি | ২২. বিবরণ |
|---|---|---|---|---|
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 অক্ষরের কী। একই কী দিয়ে একই অনুরোধ পুনরায় চেষ্টা করুন যাতে ডুপ্লিকেট কাজ এড়ানো যায়।
|
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 রিটার্ন করে।const response = await fetch('https://v1.tempmailg.com/api/outlook-alias/emails', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.post('https://v1.tempmailg.com/api/outlook-alias/emails', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/outlook-alias/emails');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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 /messages/{messageId} ব্যবহার করুন।
| প্যারামিটার | অবস্থান | ১৩. ধরন | স্থিতি | ২২. বিবরণ |
|---|---|---|---|---|
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>
|
const response = await fetch('https://v1.tempmailg.com/api/messages?email=demo123@example.com', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/messages?email=demo123@example.com', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/messages?email=demo123@example.com');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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 সারাংশ ক্ষেত্র: সংযুক্তি মেটাডেটা আছে কিনা। ডাউনলোডের প্রাপ্যতা আলাদাভাবে পরীক্ষা করা হয়। |
একটি একক বার্তা পান
একটি মালিকানাধীন বার্তা তার অস্বচ্ছ বার্তা আইডি দ্বারা পুনরুদ্ধার করুন। বডি ফরম্যাট এবং সংযুক্তি মেটাডেটা ফেরত দেয়। বডি ফিল্ডগুলি বার্তার ফরম্যাটের উপর নির্ভরশীল; Outlook নিচে তালিকাভুক্ত প্রদানকারী-নির্দিষ্ট ফিল্ডগুলি যোগ করে।
| প্যারামিটার | অবস্থান | ১৩. ধরন | স্থিতি | ২২. বিবরণ |
|---|---|---|---|---|
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>
|
const response = await fetch('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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 বডি আছে কি না। |
বার্তা মুছুন
২৫. একটি একক মালিকানাধীন বার্তা মুছে ফেলুন।
| প্যারামিটার | অবস্থান | ১৩. ধরন | স্থিতি | ২২. বিবরণ |
|---|---|---|---|---|
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 অক্ষরের কী। একই কী দিয়ে একই অনুরোধ পুনরায় চেষ্টা করুন যাতে ডুপ্লিকেট কাজ এড়ানো যায়।
|
const response = await fetch('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.delete('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'DELETE',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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 রিটার্ন করে। |
সংযুক্তি ডাউনলোড করুন
২. একটি মালিকানাধীন বার্তা থেকে একটি অ্যাটাচমেন্ট ডাউনলোড করুন।
| প্যারামিটার | অবস্থান | ১৩. ধরন | স্থিতি | ২২. বিবরণ |
|---|---|---|---|---|
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>
|
const response = await fetch('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const blob = await response.blob();
const downloadUrl = window.URL.createObjectURL(blob);
const link = document.createElement('a');
link.href = downloadUrl;
link.download = 'file.txt';
document.body.appendChild(link);
link.click();
link.remove();
window.URL.revokeObjectURL(downloadUrl);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt', headers=headers, stream=True, timeout=30)
response.raise_for_status()
with open('file.txt', 'wb') as handle:
for chunk in response.iter_content(chunk_size=8192):
if chunk:
handle.write(chunk)
<?php
$fileHandle = fopen('file.txt', 'w');
$ch = curl_init('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_FILE => $fileHandle,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
if (curl_exec($ch) === false) {
fclose($fileHandle);
throw new RuntimeException(curl_error($ch));
}
curl_close($ch);
fclose($fileHandle);
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
| ক্ষেত্র | ১৩. ধরন | ২২. বিবরণ |
|---|---|---|
Content-Disposition |
header | সফল প্রতিক্রিয়া অনুরোধকৃত ফাইলনাম ডাউনলোড করে। |
body |
binary | সফল হলে ফাইল বাইটস, JSON নয়। ত্রুটি হলে অ-২xx স্ট্যাটাস সহ JSON রিটার্ন করে। |
হার সীমা ও কোটা
ক্রেডিট ব্যবহার না করে রিয়েল-টাইম রিকোয়েস্ট বাজেট, রেট লিমিট এবং অ্যাকাউন্ট কোটা মনিটর করুন।
রেট লিমিট ও কোটা
আপনার বর্তমান রেট লিমিট এবং কোটা স্ট্যাটাস কোনো API ব্যবহার না করে পরীক্ষা করুন। এই এন্ডপয়েন্টটি কোটা-ফ্রি এবং মাসিক API ক্রেডিট কেটে না (অপব্যবহার সুরক্ষা সীমা: 60 রিকোয়েস্ট/মিনিট)।
const response = await fetch('https://v1.tempmailg.com/api/rate-limit', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/rate-limit', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/rate-limit');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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 ফিল্ডের সামঞ্জস্যতা উপনাম; ব্যালেন্স গণনা করার সময় এটি আবার যোগ করবেন না। |
মেইলবক্স ওয়েবহুকস (রিয়াল-টাইম পুশ)
নতুন মেইল আসার জন্য বারবার REST API (GET /messages) পোলিং করার পরিবর্তে, ওয়েবহুক কনফিগার করে আপনার সার্ভার বা অটোমেশন ফ্লোতে নতুন মেসেজগুলি রিয়াল টাইমে পাঠাতে পারেন।
সমর্থিত ওয়েবহুক ইভেন্টসমূহ
প্রতিটি ওয়েবহুক একটি বা একাধিক ইভেন্ট টাইপের সাথে সাবস্ক্রাইব করতে পারে। আপনার এন্ডপয়েন্ট যখন এই ট্রিগারগুলির মধ্যে একটি ঘটে তখন এটি একটি ইভেন্ট নোটিফিকেশন পায়।
নির্বাচিত মেলবক্সে নতুন বার্তা পৌঁছালে তা রিয়েল-টাইমে প্রেরিত হয়।
অস্থায়ী মেলবক্সের মেয়াদ শেষ হলে এবং ওয়েবহুক প্রক্রিয়াকরণ স্থগিত হলে প্রেরণ করা হয়।
যখন একটি মেয়াদোত্তীর্ণ মেলবক্স পরিকল্পনা নিয়মের অধীনে আবার সক্রিয় হয়, তখন প্রেরণ করা হয়।
ওয়েবহুক এবং তার মেলবক্স মুছে ফেলা হওয়ার ঠিক আগে প্রেরণ করা হয়েছে।
রিকুয়েস্ট হেডার্স ও এইচএমএসি সিগনেচার ভেরিফিকেশন
প্রতিটি ওয়েবহুক ডেলিভারি বিশেষ সিকিউরিটি হেডারসমূহ ধারণ করে। ইনকামিং রিকুয়েস্টগুলি আসলে টেম্পমেইলজ দ্বারা প্রেরিত এবং পরিবর্তিত হয়নি তা যাচাই করতে X-TempMailg-Signature হেডারটি ব্যবহার করুন।
| হেডার নাম | উদাহরণ মান | ২২. বিবরণ |
|---|---|---|
User-Agent |
TempMailg-Webhooks/1.0 | ওয়েবহুক ডেলিভারি কর্মীর জন্য মানক শনাক্তকারী। |
X-TempMailg-Event |
email.received | এই ডেলিভারিটি ট্রিগার করা ইভেন্টের ধরন। |
X-TempMailg-Event-Id |
e7b1a2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c | এই ডেলিভারি প্রচেষ্টার জন্য নির্ধারিত অনন্য UUID। |
X-TempMailg-Timestamp |
1725192000 | অনুরোধটি কখন শুরু হয়েছে তা নির্দেশকারী Unix epoch টাইমস্ট্যাম্প। |
X-TempMailg-Signature |
sha256=d7a8fbb307d7809469ca933b02d82941... | আপনার সিক্রেট ব্যবহার করে {timestamp}.{raw_body} থেকে গণনা করা HMAC-SHA256 স্বাক্ষর। |
X-TempMailg-Test |
false | আপনার ড্যাশবোর্ডের "Send Test Ping" ফিচার দ্বারা প্রেরিত হলে সত্য। |
এই স্ট্রিংয়ের উপর HMAC এর মাধ্যমে SHA256 ব্যবহার করে সিগনেচার গণনা করা হয়:
hash_hmac('sha256', "${X-TempMailg-Timestamp}.${raw_request_body}", your_webhook_secret)
স্যাম্পল ইভেন্ট পেলোড (ইমেইল.রিসিভড)
HTTP POST অনুরোধের বডিতে `application/json` হিসেবে প্রেরণ করা হয়েছে।
{
"id": "e7b1a2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"version": "1.0",
"event": "email.received",
"occurred_at": "2026-11-19T02:18:15+00:00",
"test": false,
"mailbox": {
"id": 1024,
"email": "developer@v1.tempmailg.com"
},
"data": {
"message_id": "7a8b9c0d1e2f",
"subject": "Your Verification Code: 948201",
"from": "auth@service.com",
"to": "developer@v1.tempmailg.com",
"date": "2026-11-19T02:18:15+00:00",
"attachments_count": 0,
"text_preview": "Hello, your one-time verification code is 948201. It will expire in 10 minutes.",
"email_url": "https://tempmailg.com/mailbox/1024?message=7a8b9c0d1e2f",
"inbox_url": "https://tempmailg.com/mailbox/1024"
}
}
রিসিভার ইমপ্লিমেন্টেশন উদাহরণ
আপনার ভাষা নির্বাচন করুন যাতে আপনি ওয়েবহুকগুলি কীভাবে গ্রহণ করবেন এবং HMAC স্বাক্ষরগুলি নিরাপদে যাচাই করবেন তা দেখতে পারেন।
const express = require('express');
const crypto = require('crypto');
const app = express();
const WEBHOOK_SECRET = 'your_webhook_signing_secret';
// Capture raw body buffer for HMAC-SHA256 signature verification
app.use(express.json({
verify: (req, res, buf) => {
req.rawBody = buf.toString('utf8');
}
}));
app.post('/webhook', (req, res) => {
const timestamp = req.headers['x-tempmailg-timestamp'];
const signatureHeader = req.headers['x-tempmailg-signature'] || '';
// Calculate HMAC-SHA256 signature
const expectedSignature = 'sha256=' + crypto
.createHmac('sha256', WEBHOOK_SECRET)
.update(`${timestamp}.${req.rawBody}`)
.digest('hex');
// Verify signature
if (signatureHeader !== expectedSignature) {
return res.status(401).json({ error: 'Invalid webhook signature' });
}
const { event, mailbox, data } = req.body;
console.log(`[Event: ${event}] Mailbox: ${mailbox.email}`);
if (event === 'email.received') {
console.log(`From: ${data.from}`);
console.log(`Subject: ${data.subject}`);
console.log(`Preview: ${data.text_preview}`);
}
// Acknowledge receipt with HTTP 200
res.status(200).json({ received: true });
});
app.listen(3000, () => console.log('Webhook receiver running on port 3000'));
from flask import Flask, request, jsonify
import hmac
import hashlib
app = Flask(__name__)
WEBHOOK_SECRET = b"your_webhook_signing_secret"
@app.route("/webhook", methods=["POST"])
def handle_webhook():
timestamp = request.headers.get("X-TempMailg-Timestamp", "")
signature_header = request.headers.get("X-TempMailg-Signature", "")
# Calculate expected HMAC-SHA256 signature
raw_body = request.get_data()
signed_payload = f"{timestamp}.".encode("utf-8") + raw_body
expected_signature = "sha256=" + hmac.new(
WEBHOOK_SECRET, signed_payload, hashlib.sha256
).hexdigest()
# Verify signature securely
if not hmac.compare_digest(signature_header, expected_signature):
return jsonify({"error": "Invalid signature"}), 401
payload = request.get_json()
event = payload.get("event")
mailbox = payload.get("mailbox", {}).get("email")
data = payload.get("data", {})
print(f"[{event}] Mailbox: {mailbox}")
if event == "email.received":
print(f"From: {data.get('from')}")
print(f"Subject: {data.get('subject')}")
print(f"Preview: {data.get('text_preview')}")
# Return 200 OK to acknowledge receipt
return jsonify({"received": True}), 200
if __name__ == "__main__":
app.run(port=5000)
<?php
$secret = 'your_webhook_signing_secret';
$rawBody = file_get_contents('php://input');
$timestamp = $_SERVER['HTTP_X_TEMPMAILG_TIMESTAMP'] ?? '';
$receivedSignature = $_SERVER['HTTP_X_TEMPMAILG_SIGNATURE'] ?? '';
// Calculate HMAC-SHA256 signature
$expectedSignature = 'sha256=' . hash_hmac('sha256', $timestamp . '.' . $rawBody, $secret);
// Verify signature
if (!hash_equals($expectedSignature, $receivedSignature)) {
http_response_code(401);
echo json_encode(['error' => 'Invalid signature']);
exit;
}
$payload = json_decode($rawBody, true);
$event = $payload['event'] ?? '';
$mailbox = $payload['mailbox']['email'] ?? '';
$data = $payload['data'] ?? [];
if ($event === 'email.received') {
$sender = $data['from'] ?? '';
$subject = $data['subject'] ?? '';
$preview = $data['text_preview'] ?? '';
// Process new incoming email...
}
// Acknowledge receipt
http_response_code(200);
echo json_encode(['received' => true]);
সমর্থিত প্ল্যাটফর্ম এবং অটোমেশন ইন্টিগ্রেশন
TempMailg ওয়েবহুকগুলি স্ট্যান্ডার্ড HTTPS এন্ডপয়েন্ট এবং শীর্ষস্থানীয় নো-কোড/অটোমেশন প্ল্যাটফর্মের সঙ্গে সরাসরি কাজ করে:
২০. সাধারণ ত্রুটিগুলি এবং সমস্যা সমাধান
২১. এগুলি সবচেয়ে সাধারণ প্রতিক্রিয়া কোড যা আপনি ব্যবহারকারী API একীভূত করার সময় দেখতে পারেন।
অবৈধ, অনুপস্থিত বা প্রত্যাহার করা Bearer টোকেন।
মালিকানা, বৈশিষ্ট্য অনুমতি, ডোমেইন অ্যাক্সেস বা সংযুক্তির আকার অপারেশনটি বাধা দিয়েছে। প্রতিক্রিয়া কোড এবং বার্তা পরীক্ষা করুন।
৭. সংস্থানটি অনুমোদিত হোস্টে পাওয়া যায়নি বা ব্যবহারকারীর অন্তর্গত নয়।
অপারেশন কীটি ভিন্ন বিবরণসহ পুনরায় ব্যবহার করা হয়েছে, অন্য একটি অপারেশন মুলতুবি রয়েছে, অথবা মেলবক্সের নিরাপত্তা পরিবর্তিত হয়েছে। পুনরায় চেষ্টা করার আগে কোডটি পরীক্ষা করুন।
৮. মেইলবক্স মেয়াদোত্তীর্ণ বা নিষ্ক্রিয়।
অবৈধ প্যারামিটার, অগ্রহণযোগ্য লাইফটাইম, অপ্রাপ্য উপনাম ক্ষমতা, অবৈধ PIN সেটআপ অথবা অনুপস্থিত/অবৈধ Idempotency-Key অপারেশনটি বাধা দিয়েছে।
একটি সুরক্ষিত মেলবক্সের জন্য একটি বৈধ স্কোপড X-Mailbox-Unlock টোকেন প্রয়োজন। মুছে ফেলার জন্য প্রতিক্রিয়া থেকে action এবং target_id ব্যবহার করুন। পুনরায় চেষ্টা করার আগে লকআউট বা পুনরুদ্ধার প্রয়োজনীয়তা সমাধান করতে হবে।
একটি অনুরোধ সীমা, নিষ্ক্রিয় পরিকল্পনা, শেষ হয়ে যাওয়া কোটা, অথবা কুলডাউন অপারেশনটি বাধা দিয়েছে। কারণ এবং উপলব্ধ বাজেট হেডারগুলি পরীক্ষা করুন। Retry-After ঐচ্ছিক।
সার্ভার অপারেশনটি সম্পন্ন করতে পারেনি। সুরক্ষিত তৈরি বা মুছে ফেলা জন্য, পুনরায় চেষ্টা করার সময় একই অনুরোধ এবং Idempotency-Key সংরক্ষণ করুন।
প্রোটেকশন স্টোরেজ বা সমন্বয় যাচাই করা যায়নি। নির্দেশিত বিলম্বের পরে পুনরায় চেষ্টা করুন। এই প্রতিক্রিয়া একটি ব্যর্থ পেমেন্ট নয়।
২২. দ্রুত তালিকা
- 401 Unauthorized - ২৩. বেয়ারার টোকেন নেই, ভুল, বাতিল বা ভুলভাবে অনুলিপি করা হয়েছে।
- 403 Forbidden - ২৪.
- 404 Not Found - রিসোর্স পাওয়া যাচ্ছে না বা অপ্রবল প্যারামিটার
- 410 Gone / Expired - মেইলবক্সের মেয়াদ উত্তীর্ণ হয়েছে অথবা এটি আর সক্রিয় নেই।
- 429 Rate Limited - প্রতিক্রিয়া কারণ এবং বাজেট হেডারগুলি পরীক্ষা করুন। রিট্রাই-আফটার শুধুমাত্র সময়সীমার জন্য প্রযোজ্য; শেষ হয়ে যাওয়া ক্রেডিট বা নিষ্ক্রিয় অ্যাক্সেসের জন্য একটি অ্যাকাউন্ট পরিবর্তন প্রয়োজন হতে পারে।
প্রস্তাবিত পরবর্তী পদক্ষেপ
আপনি যদি সাইন ইন করে থাকেন, তাহলে আপনার বাহ্যিক অ্যাপ ডিবাগ করার আগে প্রথমে API ম্যানেজমেন্ট খুলুন এবং আপনার কী, কোটা, প্ল্যান অ্যাক্সেসের অবস্থা এবং সঠিক ব্যবহারকারী API বেস URL নিশ্চিত করুন।