त्वरित सेटअप चेकलिस्ट
- अपने डैशबोर्ड एपीआई प्रबंधन पृष्ठ खोलें और अपनी व्यक्तिगत एपीआई कुंजी बनाएं।
- वहां दिखाए गए सटीक उपयोगकर्ता एपीआई बेस यूआरएल की प्रतिलिपि बनाएं, उदाहरण के लिए https://v1.tempmailg.com/api.
- उस एपीआई होस्ट के साथ हर अनुरोध भेजें Authorization: Bearer YOUR_USER_API_KEY और Accept: application/json.
- समान डैशबोर्ड पृष्ठ से और उपयोगकर्ता API प्रतिक्रियाओं में उपलब्ध होने पर कोटा हेडर से अपनी मासिक अनुरोध कोटा को ट्रैक करें। केवल सफल 2xx अनुरोध कोटा में गिने जाते हैं।
एपीआई कुंजी एक्सेस
लॉग इन करें अपनी व्यक्तिगत एपीआई कुंजी बनाने और लाइव कोटा विवरण देखने के लिए।
प्रमाणीकरण प्रवाह
- डैशबोर्ड एपीआई प्रबंधन पेज से अपनी व्यक्तिगत एपीआई कुंजी उत्पन्न करें।
- हर अनुरोध में कुंजी को एक बियरर टोकन के रूप में भेजें।
- अपने एपीआई प्रबंधन पेज पर दिखाए गए विशिष्ट उपयोगकर्ता एपीआई बेस यूआरएल का उपयोग करें।
- पुरानी कुंजी को अमान्य करने और तुरंत एक नई कुंजी का उपयोग शुरू करने के लिए कुंजी को पुनः उत्पन्न करें।
आवश्यक हेडर
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— Unix टाइमस्टैम्प जब वर्तमान मिनट रेट लिमिट विंडो रीसेट होती है।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-*— अलग मेलबॉक्स निर्माण/अपडेट बजट। सफल मेलबॉक्स प्रतिक्रियाएँ खाता RPM को X-RateLimit-* में रखती हैं; एक केवल-मेलबॉक्स अस्वीकृति मेलबॉक्स स्कोप और उसके अपने रीट्राई विंडो का उपयोग करती है।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 | वैकल्पिक |
वैकल्पिक कस्टम उपयोगकर्ता नाम: 2 से 64 ASCII अक्षर, अंक, डॉट, अंडरस्कोर या हाइफ़न। योजना अनुमति की आवश्यकता है; custom_username भी स्वीकार किया जाता है।
डिफ़ॉल्ट:
रैंडम रूप से उत्पन्न
|
domain
|
body | string | वैकल्पिक |
GET /domains द्वारा लौटाए गए अनुमत डोमेनों में से एक। अनुपस्थिति एक यादृच्छिक अनुमत डोमेन चुनती है।
डिफ़ॉल्ट:
रैंडम अनुमत डोमेन
|
lifetime
|
body | string | वैकल्पिक |
अनुमत मान:
10m — १० मिनट
1h — 1 घंटा
2h — 2 घंटे
1d — 1 दिन
1w — 1 सप्ताह
1m — 30 दिन
3m — 90 दिन
6m — 180 दिन
1y — 365 दिन
unlimited — असीमित
डिफ़ॉल्ट:
योजना की डिफ़ॉल्ट जीवनकाल
|
provider
|
body | string | वैकल्पिक |
मेलबॉक्स प्रदाता: standard, gmail_alias, या outlook_alias।
डिफ़ॉल्ट:
standard
|
pin_enabled
|
body | boolean | वैकल्पिक |
जब आपके प्लान द्वारा अनुमति दी गई हो, नए मेलबॉक्स के लिए वैकल्पिक PIN सुरक्षा। यह मौजूदा मेलबॉक्स के PIN को नहीं बदलता।
डिफ़ॉल्ट:
false
|
pin
|
body | string | वैकल्पिक |
जब pin_enabled true हो तो आवश्यक: 6 से 8 अंकों का 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:22+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:22+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 | गणना के समय शेष गैर-नकारात्मक सेकंड; अंशात्मक सेकंड संभव हैं। 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 | अस्पष्ट एन्क्रिप्टेड मेलबॉक्स संदर्भ। यह बेयर प्रमाणीकरण, स्वामित्व जांच या पिन प्राधिकरण को प्रतिस्थापित नहीं करता है। |
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 | रीड ग्रांट के लिए अनुमत निष्क्रिय समय, सामान्यतः 3600 सेकंड। |
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 | आवश्यक |
नया इच्छित उपयोगकर्ता नाम: 2 से 64 अल्फ़ान्यूमेरिक अक्षर; कस्टम उपयोगकर्ता नाम अनुमति के अधीन।
|
domain
|
path | string | आवश्यक |
नया अनुमत डोमेन नाम।
|
lifetime
|
body | string | वैकल्पिक |
अनुमत मान:
10m — १० मिनट
1h — 1 घंटा
2h — 2 घंटे
1d — 1 दिन
1w — 1 सप्ताह
1m — 30 दिन
3m — 90 दिन
6m — 180 दिन
1y — 365 दिन
unlimited — असीमित
डिफ़ॉल्ट:
योजना की डिफ़ॉल्ट जीवनकाल
|
pin_enabled
|
body | boolean | वैकल्पिक |
जब आपके प्लान द्वारा अनुमति दी गई हो, नए मेलबॉक्स के लिए वैकल्पिक PIN सुरक्षा। यह मौजूदा मेलबॉक्स के PIN को नहीं बदलता।
डिफ़ॉल्ट:
false
|
pin
|
body | string | वैकल्पिक |
जब pin_enabled true हो तो आवश्यक: 6 से 8 अंकों का PIN, अग्रणी शून्य को संरक्षित रखने के लिए स्ट्रिंग के रूप में भेजा जाता है।
|
pin_confirmation
|
body | string | वैकल्पिक |
जब pin_enabled सत्य हो तो आवश्यक है। pin से बिल्कुल मेल खाना चाहिए।
|
Idempotency-Key
|
header | string | वैकल्पिक |
PIN-संरक्षित निर्माण या हटाने के लिए आवश्यक: एक स्थिर 16 से 128 अक्षरों की कुंजी। डुप्लिकेट कार्य से बचने के लिए समान कुंजी के साथ समान अनुरोध को पुनः प्रयास करें।
|
X-Mailbox-Unlock
|
header | string | वैकल्पिक |
हेडर, केवल संरक्षित मेलबॉक्स: पढ़ने के लिए unlock_token का उपयोग करें। पहले POST pin और scope=read को PIN अनलॉक 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:22+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:22+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 | गणना के समय शेष गैर-नकारात्मक सेकंड; अंशात्मक सेकंड संभव हैं। 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 | अस्पष्ट एन्क्रिप्टेड मेलबॉक्स संदर्भ। यह बेयर प्रमाणीकरण, स्वामित्व जांच या पिन प्राधिकरण को प्रतिस्थापित नहीं करता है। |
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 | रीड ग्रांट के लिए अनुमत निष्क्रिय समय, सामान्यतः 3600 सेकंड। |
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 प्रतिक्रिया द्वारा PIN अनलॉक URL पर लौटाए गए action/target_id। एक पढ़ने वाला टोकन डिलीट नहीं कर सकता। <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 उपनाम
उच्च-प्रतिष्ठा वाले Gmail और Outlook/Hotmail उपनाम मेलबॉक्स बनाएं।
Gmail उपनाम बनाएं
प्रमाणित उपयोगकर्ता द्वारा स्वामित्व वाला नया Gmail उपनाम अस्थायी मेलबॉक्स बनाएं।
| पैरामीटर | स्थान | प्रकार | स्थिति | २२. विवरण |
|---|---|---|---|---|
mode
|
body | string | वैकल्पिक |
जनरेशन मोड: auto, dot, plus, या plus_dot। gmail_alias_mode भी स्वीकार करता है। यदि शैली चयन की अनुमति नहीं है, तो auto उपयोग किया जाता है।
डिफ़ॉल्ट:
auto
|
username
|
body | string | वैकल्पिक |
वैकल्पिक कस्टम उपनाम प्रत्यय: 2 से 32 ASCII अक्षर या अंक, लोअरकेस में सामान्यीकृत; फीचर अनुमति के अधीन। साथ ही custom_username या alias_username को स्वीकार करता है।
डिफ़ॉल्ट:
स्वतः-उत्पन्न
|
domain
|
body | string | वैकल्पिक |
रैंडम, gmail.com या googlemail.com का उपयोग करें; alias_domain भी स्वीकार किया जाता है। यदि छोड़ा गया या डोमेन चयन अनुमति उपलब्ध नहीं है तो रैंडम का उपयोग किया जाता है।
डिफ़ॉल्ट:
random
|
lifetime
|
body | string | वैकल्पिक |
अनुमत मान:
10m — १० मिनट
1h — 1 घंटा
2h — 2 घंटे
1d — 1 दिन
1w — 1 सप्ताह
1m — 30 दिन
3m — 90 दिन
6m — 180 दिन
1y — 365 दिन
unlimited — असीमित
डिफ़ॉल्ट:
योजना की डिफ़ॉल्ट जीवनकाल
|
pin_enabled
|
body | boolean | वैकल्पिक |
जब आपके प्लान द्वारा अनुमति दी गई हो, नए मेलबॉक्स के लिए वैकल्पिक PIN सुरक्षा। यह मौजूदा मेलबॉक्स के PIN को नहीं बदलता।
डिफ़ॉल्ट:
false
|
pin
|
body | string | वैकल्पिक |
जब pin_enabled true हो तो आवश्यक: 6 से 8 अंकों का 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:22+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:22+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 | गणना के समय शेष गैर-नकारात्मक सेकंड; अंशात्मक सेकंड संभव हैं। 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 | अस्पष्ट एन्क्रिप्टेड मेलबॉक्स संदर्भ। यह बेयर प्रमाणीकरण, स्वामित्व जांच या पिन प्राधिकरण को प्रतिस्थापित नहीं करता है। |
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 | रीड ग्रांट के लिए अनुमत निष्क्रिय समय, सामान्यतः 3600 सेकंड। |
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 | वैकल्पिक |
वैकल्पिक कस्टम उपनाम प्रत्यय: 2 से 32 ASCII अक्षर या अंक, लोअरकेस में सामान्यीकृत; फीचर अनुमति के अधीन। साथ ही custom_username या alias_username को स्वीकार करता है।
डिफ़ॉल्ट:
स्वतः-उत्पन्न
|
lifetime
|
body | string | वैकल्पिक |
अनुमत मान:
10m — १० मिनट
1h — 1 घंटा
2h — 2 घंटे
1d — 1 दिन
1w — 1 सप्ताह
1m — 30 दिन
3m — 90 दिन
6m — 180 दिन
1y — 365 दिन
unlimited — असीमित
डिफ़ॉल्ट:
योजना की डिफ़ॉल्ट जीवनकाल
|
pin_enabled
|
body | boolean | वैकल्पिक |
जब आपके प्लान द्वारा अनुमति दी गई हो, नए मेलबॉक्स के लिए वैकल्पिक PIN सुरक्षा। यह मौजूदा मेलबॉक्स के PIN को नहीं बदलता।
डिफ़ॉल्ट:
false
|
pin
|
body | string | वैकल्पिक |
जब pin_enabled true हो तो आवश्यक: 6 से 8 अंकों का 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:22+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:22+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 | गणना के समय शेष गैर-नकारात्मक सेकंड; अंशात्मक सेकंड संभव हैं। 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 | अस्पष्ट एन्क्रिप्टेड मेलबॉक्स संदर्भ। यह बेयर प्रमाणीकरण, स्वामित्व जांच या पिन प्राधिकरण को प्रतिस्थापित नहीं करता है। |
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 | रीड ग्रांट के लिए अनुमत निष्क्रिय समय, सामान्यतः 3600 सेकंड। |
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/टेक्स्ट संदेश पढ़ें, और अटैचमेंट्स को स्ट्रीम करें।
मेलबॉक्स संदेशों की सूची
उपलब्ध संदेश सारांश और मेलबॉक्स मेटाडेटा प्राप्त करें। मानक इनबॉक्स स्कैन अधिकतम 25 संदेशों के एक हालिया बैच को लौटाते हैं; यह पेजिनेटेड पूर्ण इतिहास एन्डपॉइंट नहीं है। पूर्ण बॉडी और अटैचमेंट के लिए GET /messages/{messageId} का उपयोग करें।
| पैरामीटर | स्थान | प्रकार | स्थिति | २२. विवरण |
|---|---|---|---|---|
email
|
query | string | आवश्यक |
स्वामित्व वाले मेलबॉक्स का पूर्ण ईमेल पता जिससे संदेश पढ़े जाएँ। क्वेरी मान को URL-encode करें; प्लस साइन को %2B के रूप में एन्कोड करें।
|
X-Mailbox-Unlock
|
header | string | वैकल्पिक |
हेडर, केवल संरक्षित मेलबॉक्स: पढ़ने के लिए unlock_token का उपयोग करें। पहले POST pin और scope=read को PIN अनलॉक 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:22",
"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:22+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:22+00:00",
"message_count_synced_at": "2026-11-19T02:18:22+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 | गणना के समय शेष गैर-नकारात्मक सेकंड; अंशात्मक सेकंड संभव हैं। 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 | एकल‑संदेश, हटाने और अटैचमेंट एंडपॉइंट्स द्वारा उपयोग किया गया अस्पष्ट संदेश ID। |
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 सारांश फ़ील्ड: क्या अटैचमेंट मेटाडेटा मौजूद है। डाउनलोड उपलब्धता अलग से जाँच की जाती है। |
एकल संदेश प्राप्त करें
एक स्वामित्व वाले संदेश को उसके अस्पष्ट संदेश ID द्वारा प्राप्त करें। बॉडी फ़ॉर्मेट और अटैचमेंट मेटाडेटा लौटाता है। बॉडी फ़ील्ड संदेश फ़ॉर्मेट पर निर्भर करते हैं; Outlook नीचे सूचीबद्ध प्रदाता-विशिष्ट फ़ील्ड जोड़ता है।
| पैरामीटर | स्थान | प्रकार | स्थिति | २२. विवरण |
|---|---|---|---|---|
messageId
|
path | string | आवश्यक |
संदेश सूची में लौटाया गया अद्वितीय संदेश आईडी।
|
X-Mailbox-Unlock
|
header | string | वैकल्पिक |
हेडर, केवल संरक्षित मेलबॉक्स: पढ़ने के लिए unlock_token का उपयोग करें। पहले POST pin और scope=read को PIN अनलॉक 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:22",
"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 | अस्पष्ट संदेश ID। |
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 | मानक/Gmail मेटाडेटा फ़ील्ड: प्रदान किए जाने पर फ़ाइल एक्सटेंशन। |
data.attachments[].id |
string | Outlook मेटाडेटा फ़ील्ड: प्रदाता अटैचमेंट ID। |
data.attachments[].content_type |
string | Outlook मेटाडेटा फ़ील्ड: MIME कंटेंट टाइप। |
data.from_name |
string|null | आउटलुक विवरण फ़ील्ड: मूल प्रेषक का नाम। |
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 प्रतिक्रिया द्वारा PIN अनलॉक URL पर लौटाए गए action/target_id। एक पढ़ने वाला टोकन डिलीट नहीं कर सकता। <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 का उपयोग करें। पहले POST pin और scope=read को PIN अनलॉक 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 नहीं। त्रुटियों में गैर-2xx स्थिति के साथ 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 | बेस मासिक योजना भत्ता। -1 का मान असीमित का अर्थ है। |
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 | क्रेडिट बैलेंस का सक्रिय योजना-बोनस भाग; purchased_credits का विवरण, अतिरिक्त क्षमता नहीं। |
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 | डैशबोर्ड-संगत 0 से 100 तक का गोल किया गया प्रतिशत: उपयोग को (उपयोग + शेष) से विभाजित करके, 100 से गुणा किया जाता है। इसमें उपलब्ध क्रेडिट क्षमता शामिल है, इसलिए रिचार्ज करने से प्रतिशत कम हो सकता है। यह अनलिमिटेड कोटा या शून्य आकार के पूल के लिए 0 है; यह मिनट दर-सीमा प्रतिशत या पहुँच निर्णय नहीं है। |
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) को पोल करने के बजाय, वेबहुक्स को कॉन्फ़िगर करें ताकि नए मेसेजेज को रियल टाइम में आपकी सर्वर या ऑटोमेशन वर्कफ़्लो में पुश किया जा सके।
सहायता प्राप्त वेबहुक घटनाएँ
हर वेबहुक एक या अधिक घटना प्रकारों के लिए सब्सक्राइब कर सकता है। आपका एंडपॉइंट तब एक घटना सूचना प्राप्त करता है जब इनमें से कोई ट्रिगर हो जाता है।
जब भी नया संदेश चयनित मेलबॉक्स तक पहुँचता है, वास्तविक समय में भेजा जाता है।
अस्थायी मेलबॉक्स के समाप्त होने पर और webhook प्रोसेसिंग के विराम पर भेजा जाता है।
जब एक समाप्त मेलबॉक्स योजना नियमों के तहत फिर से सक्रिय हो जाता है, तब भेजा जाता है।
वेबहुक और उसका मेलबॉक्स हटाए जाने से ठीक पहले भेजा गया।
आवश्यक हेडर्स और HMAC हस्ताक्षर सत्यापन
हर वेबहुक डिलीवरी में विशेष सुरक्षा हेडर शामिल होते हैं। X-TempMailg-Signature हेडर का उपयोग करके सुनिश्चित करें कि आने वाले अनुरोधों को वास्तव में TempMailg द्वारा भेजा गया है और इनमें कोई बदलाव नहीं किया गया है।
| शीर्षक नाम | उदाहरण मान | २२. विवरण |
|---|---|---|
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... | HMAC-SHA256 हस्ताक्षर {timestamp}.{raw_body} से गणना किया गया, आपके सीक्रेट का उपयोग करके। |
X-TempMailg-Test |
false | सही जब आपके डैशबोर्ड में "Send Test Ping" सुविधा द्वारा भेजा जाता है। |
हस्ताक्षर एचएमएसी के साथ गणना किए जाते हैं, शा२५६ द्वारा इस स्ट्रिंग पर:
hash_hmac('sha256', "${X-TempMailg-Timestamp}.${raw_request_body}", your_webhook_secret)
उदाहरण इवेंट पेयलोड (email.received)
HTTP POST अनुरोध के शरीर में application/json के रूप में भेजा गया
{
"id": "e7b1a2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"version": "1.0",
"event": "email.received",
"occurred_at": "2026-11-19T02:18:23+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:23+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 एंडपॉइंट्स और प्रमुख नो-कोड/ऑटोमेशन प्लेटफ़ॉर्म के साथ काम करते हैं:
सामान्य त्रुटियाँ और समस्या निवारण
ये सबसे सामान्य प्रतिक्रिया कोड हैं जिन्हें आप उपयोगकर्ता एपीआई को एकीकृत करते समय देख सकते हैं।
अमान्य, अनुपलब्ध या निरस्त 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 - प्रतिक्रिया कारण और बजट हेडर की जाँच करें। Retry-After केवल समय-सीमाओं पर लागू होता है; समाप्त क्रेडिट या अक्षम एक्सेस के लिए खाता परिवर्तन आवश्यक हो सकता है।
अगले चरण की सिफारिश की जाती है
यदि आप साइन इन हैं, तो पहले एपीआई प्रबंधन खोलें और डीबगिंग आपके बाहरी ऐप से पहले अपनी कुंजी, कोटा, योजना एक्सेस स्थिति और सटीक उपयोगकर्ता एपीआई बेस यूआरएल की पुष्टि करें।