Tmailor Open API

टेस्टिंग और ऑटोमेशन के लिए Temp Mail API

अपने कोड से केवल प्राप्त करने वाले अस्थायी ईमेल पते बनाएं और आने वाले संदेशों को JSON के रूप में पढ़ें। हर पता तब तक आपके Tmailor खाते में रहता है जब तक आप उसे हटा नहीं देते, और API संदेश में मिलने वाला वन-टाइम कोड लौटाता है।

अंतिम अपडेट: October 2026

मुफ़्त शुरू करें API दस्तावेज़ पढ़ें

प्लान और सीमाएँ देखें

REST और JSON
SDK, CLI और MCP सर्वर
100 मुफ़्त मेलबॉक्स प्रति माह
केवल प्राप्ति, 24 घंटे तक संदेश

export TMAILOR_API_KEY="tmk_live_..."

# returns 201 with email, token, web.reuse_url
curl -s -X POST https://open-api.tmailor.com/v1/mailboxes \
  -H "Authorization: Bearer $TMAILOR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

# pip install tmailor-sdk
from tmailor import Client

with Client() as client:  # reads TMAILOR_API_KEY
    box = client.mailboxes.create()
    print(box.email)

    # trigger the email, then wait for it
    msg = box.wait_for_message(
        timeout=120, since=(box.created_at or 0) - 1)
    print(msg.subject, msg.otp(), msg.links())

// npm install tmailor
import { Client } from "tmailor";

const client = new Client(); // reads TMAILOR_API_KEY
const box = await client.mailboxes.create();
console.log(box.email);

// trigger the email, then wait for it
const msg = await box.waitForMessage({
  timeout: 120_000, since: box.createdAt - 1 });
console.log(msg.subject, msg.otp, msg.links);

<?php // composer require tmailor/tmailor
use Tmailor\Client;

$client = new Client(); // reads TMAILOR_API_KEY
$box = $client->mailboxes->create();
echo $box->email, "\n";

// trigger the email, then wait for it
$msg = $box->waitForMessage(
    timeout: 120, since: $box->createdAt - 1);
echo $msg->subject, ' ', $msg->otp;

पता बनाएं, ईमेल का इंतज़ार करें, कोड पढ़ें।

प्रति मेलबॉक्स भुगतान करें, प्रति अनुरोध नहीं

केवल पता बनाने पर आपका मेलबॉक्स कोटा खर्च होता है। पते की सूची देखना, इनबॉक्स जाँचना और संदेश पढ़ना या हटाना इसके अंतर्गत नहीं आता। सशुल्क योजनाओं में दैनिक या मासिक अनुरोध कोटा नहीं होता, केवल प्रति मिनट दर सीमा होती है।

उदाहरण: एक OTP परीक्षण जो एक पता बनाता है और इनबॉक्स 25 बार जाँचता है, एक ही मेलबॉक्स गिना जाता है।

API कुंजी से इनबॉक्स तक चार चरणों में

API कुंजी बनाएँ
अपने tmailor.com खाते या Google से API प्लेटफ़ॉर्म में साइन इन करें और एक key बनाएं। Free प्लान पर, वह एक सर्वर IP पता भी जोड़ें जो API को कॉल करेगा।
पता बनाएँ
साझा डोमेन पर यादृच्छिक पता पाने के लिए एक अनुरोध भेजें, या अपने स्वामित्व वाले और सत्यापित डोमेन पर कस्टम नाम चुनें।
संदेश पढ़ें
इनबॉक्स की सूची देखें और हर संदेश को JSON के रूप में पढ़ें: प्रेषक, विषय, टेक्स्ट, साफ़ किया गया HTML, और API द्वारा खोजा गया वन-टाइम कोड व लिंक।
इसे रखें या हटाएँ
पतों की समय-सीमा समाप्त नहीं होती। उसी इनबॉक्स को उसके रीयूज़ लिंक के साथ tmailor.com पर खोलें, या परीक्षण पूरा होने पर पता हटा दें।

दोहराने योग्य ईमेल वर्कफ़्लो के लिए बनाया गया

एक ही वास्तविक मेलबॉक्स साझा करने के बजाय हर परीक्षण को अपना अलग इनबॉक्स दें।

साइन-अप और OTP परीक्षण

हर साइन-अप, पासवर्ड रीसेट या वन-टाइम कोड जाँच के लिए नया पता बनाएँ, फिर रिस्पॉन्स से कोड पढ़ें।

CI/CD पाइपलाइन

एनवायरनमेंट वेरिएबल में कुंजी रखकर अपनी पाइपलाइन में एंड-टू-एंड ईमेल जाँच चलाएँ। सशुल्क प्लान किसी भी IP पते से अनुरोध स्वीकार करते हैं।

QA और स्टेजिंग

परीक्षकों और स्टेजिंग एनवायरनमेंट को उनके अपने पते दें और वास्तविक इनबॉक्स को परीक्षण डेटा से बाहर रखें।

अपने स्वयं के डोमेन पर पते

एक डोमेन जो आपके स्वामित्व में है जोड़ें, उसका MX रिकॉर्ड हमारी ओर इंगित करें और नामकरण नियमों का पालन करने वाले कस्टम नामों के साथ पते बनाएँ।

प्लान और मूल्य

अपनी ज़रूरत के अनुसार मेलबॉक्स की संख्या चुनें। आपका कोटा हर 30 दिन में रीसेट होता है, वार्षिक प्लान पर भी।

मुफ़्त

API आज़माएँ और छोटी परियोजनाएँ चलाएँ।

$0 /माह

हर 30 दिनों में 100 मेलबॉक्स
प्रति मिनट अधिकतम 30 अनुरोध
प्रति दिन 2,000 अनुरोध
एक अनुमत IP से कॉल
साझा डोमेन और आपके अपने डोमेन

मुफ़्त शुरू करें

स्टार्टर

किसी डेवलपर या छोटे टेस्ट सूट के लिए।

$9 /माह

हर 30 दिनों में 3,000 मेलबॉक्स
प्रति मिनट अधिकतम 300 अनुरोध
दैनिक या मासिक अनुरोध कोटा नहीं
किसी भी IP पते से कॉल
साझा डोमेन और आपके अपने डोमेन

स्टार्टर चुनें

प्रो

उन टीमों के लिए जो हर दिन टेस्ट चलाती हैं।

$29 /माह

हर 30 दिनों में 30,000 मेलबॉक्स
प्रति मिनट अधिकतम 600 अनुरोध
दैनिक या मासिक अनुरोध कोटा नहीं
किसी भी IP पते से कॉल
साझा डोमेन और आपके अपने डोमेन

प्रो चुनें

बिज़नेस

भारी दैनिक ऑटोमेशन वाली कंपनियों के लिए।

$99 /माह

हर 30 दिनों में 150,000 मेलबॉक्स
प्रति मिनट अधिकतम 2,000 अनुरोध
दैनिक या मासिक अनुरोध कोटा नहीं
किसी भी IP पते से कॉल
साझा डोमेन और आपके अपने डोमेन

बिज़नेस चुनें

Scale

बड़े टेस्ट फ़्लीट और व्यस्त पाइपलाइनों के लिए।

$199 /माह

हर 30 दिनों में 400,000 मेलबॉक्स
प्रति मिनट अधिकतम 4,000 अनुरोध
दैनिक या मासिक अनुरोध कोटा नहीं
किसी भी IP पते से कॉल
साझा डोमेन और आपके अपने डोमेन

Scale चुनें

Enterprise

सबसे अधिक मेलबॉक्स वॉल्यूम और अनुरोध दर के लिए।

$499 /माह

हर 30 दिनों में 2,000,000 मेलबॉक्स
प्रति मिनट अधिकतम 6,000 अनुरोध
दैनिक या मासिक अनुरोध कोटा नहीं
किसी भी IP पते से कॉल
साझा डोमेन और आपके अपने डोमेन

Enterprise चुनें

योजनाओं की तुलना करें

ये सीमाएं हर योजना में अलग होती हैं। बाकी सब कुछ हर योजना में समान है।

योजनाओं की तुलना करें
योजना	मुफ़्त	स्टार्टर	प्रो	बिज़नेस	Scale	Enterprise
मासिक मूल्य	$0	$9	$29	$99	$199	$499
वार्षिक मूल्य	$0	$90	$290	$990	$1,990	$4,990
हर 30 दिनों में मेलबॉक्स	100	3,000	30,000	150,000	400,000	2,000,000
प्रति मिनट अनुरोध	30	300	600	2,000	4,000	6,000
दैनिक अनुरोध सीमा	2,000	कोई सीमा नहीं	कोई सीमा नहीं	कोई सीमा नहीं	कोई सीमा नहीं	कोई सीमा नहीं
IP अनुमति सूची	आवश्यक, 1 IP	आवश्यक नहीं	आवश्यक नहीं	आवश्यक नहीं	आवश्यक नहीं	आवश्यक नहीं
होस्टेड MCP सर्वर	केवल स्थानीय सर्वर	शामिल	शामिल	शामिल	शामिल	शामिल

सभी योजनाओं की तुलना करने के लिए बग़ल में स्वाइप करें।

हर योजना में शामिल

JSON प्रतिक्रियाओं वाला REST API
साझा डोमेन पर यादृच्छिक पते
अपने स्वयं के सत्यापित डोमेन पर कस्टम नाम
असीमित अपने डोमेन (एक साथ अधिकतम 3 सत्यापन की प्रतीक्षा में रह सकते हैं)
ऐसे पते जो समाप्त नहीं होते
आप कितने पते रखते हैं, इसकी कोई सीमा नहीं
संदेश 24 घंटे तक रखे जाते हैं
वन-टाइम कोड और लिंक निकालना (सर्वोत्तम प्रयास)
tmailor.com पर इनबॉक्स खोलने के लिए रीयूज़ लिंक
आधिकारिक SDK और कमांड-लाइन टूल
योजनाओं को जोड़ा जा सकता है और उनकी सीमाएं जुड़ जाती हैं
केवल प्राप्त करने के लिए, अनुलग्नकों के बिना
पता हटाने से कोटा वापस नहीं मिलता

जब चक्र का मेलबॉक्स कोटा खत्म हो जाता है, तो अगले चक्र तक या अपग्रेड करने तक नए पते नहीं बनाए जा सकते। मौजूदा इनबॉक्स काम करते रहते हैं।
API शर्तों के अनुसार भुगतान वापस नहीं किया जाता। पहले Free योजना पर अपने एकीकरण का परीक्षण करें।

आधिकारिक SDK और CLI

टाइप्ड मॉडल, स्वचालित पुनःप्रयास और अगले संदेश की प्रतीक्षा करने वाले हेल्पर के साथ अपनी भाषा से API कॉल करें। हर SDK एक ही API और साझा परीक्षण परिदृश्यों का पालन करता है।

Python

उपलब्ध

Python 3.9+

pip install tmailor-sdk

इसमें tmailor आदेश-पंक्ति उपकरण शामिल है।

PyPI पर देखें GitHub पर स्रोत

Node.js

उपलब्ध

Node.js 18+, TypeScript types

npm install tmailor

npm पर देखें GitHub पर स्रोत

PHP

उपलब्ध

PHP 8.1+

composer require tmailor/tmailor

Packagist पर देखें GitHub पर स्रोत

AI एजेंट के लिए

AI एजेंट के लिए MCP सर्वर

Claude, Cursor, VS Code Copilot और अन्य MCP क्लाइंट को अपने या जिन्हें परखने की अनुमति है उन साइन-अप फ़्लो का परीक्षण करने दें: एजेंट एक असली, केवल-प्राप्ति वाला पता बनाता है, ईमेल का इंतज़ार करता है और वन-टाइम कोड या सत्यापन लिंक पढ़ता है।

दोनों विकल्प एजेंट को एक जैसे टूल देते हैं: पता बनाना, ईमेल का इंतज़ार करना और उसका वन-टाइम कोड व लिंक पाना, संदेश पढ़ना, पते हटाना और अपना कोटा जाँचना। एजेंट सिर्फ़ ईमेल पते देखता है, उनके पीछे के token कभी नहीं, और यह API जैसा ही मेलबॉक्स कोटा और दर सीमा इस्तेमाल करता है।

होस्टेड सर्वर

कुछ भी इंस्टॉल करने की ज़रूरत नहीं

https://mcp.tmailor.com/mcp

अपने AI ऐप में सर्वर URL जोड़ें। साइन-इन का समर्थन करने वाले ऐप्स, जैसे Claude, ChatGPT और Codex, आपको एक्सेस स्वीकृत करने के लिए Tmailor प्लेटफ़ॉर्म पर भेजते हैं। अन्य क्लाइंट Authorization हेडर में आपकी API कुंजी भेजते हैं।

सक्रिय सशुल्क प्लान आवश्यक है। कॉल हमारे सर्वर से आते हैं, इसलिए आपको IP अनुमति सूची की ज़रूरत नहीं है।

# Claude: add a custom connector with this URL,
# then approve access on the Tmailor platform
https://mcp.tmailor.com/mcp

# Claude Code, with your API key
claude mcp add --transport http tmailor \
  https://mcp.tmailor.com/mcp \
  --header "Authorization: Bearer tmk_live_..."

# Codex CLI, with your API key
export TMAILOR_API_KEY=tmk_live_...
codex mcp add tmailor \
  --url https://mcp.tmailor.com/mcp \
  --bearer-token-env-var TMAILOR_API_KEY

# Cursor (~/.cursor/mcp.json)
{"mcpServers": {"tmailor": {
  "url": "https://mcp.tmailor.com/mcp",
  "headers": {"Authorization": "Bearer tmk_live_..."}}}}

AI कनेक्शन पेज पर कनेक्ट किए गए ऐप्स देखें और उनमें से किसी को भी डिस्कनेक्ट करें। डिस्कनेक्ट किया गया ऐप 30 सेकंड के भीतर एक्सेस खो देता है।

प्लान और सीमाएँ देखें

स्थानीय सर्वर

हर प्लान में, मुफ़्त में भी

tmailor-mcp

यह आपके कंप्यूटर पर चलता है, आपकी कुंजी TMAILOR_API_KEY से पढ़ता है और इसके लिए uv या Python 3.10+ चाहिए। Free प्लान पर, उस कंप्यूटर का IP allowlist में जोड़ें।

# Claude Code
claude mcp add tmailor \
  -e TMAILOR_API_KEY=tmk_live_... \
  -- uvx tmailor-mcp

# Claude Desktop, Cursor, VS Code
#   command: uvx   args: ["tmailor-mcp"]

# without uv
pip install tmailor-mcp

PyPI पर देखें हर MCP क्लाइंट के लिए सेटअप

यह पूछकर देखें: "एक अस्थायी ईमेल बनाओ, उससे मेरी स्टेजिंग साइट पर साइन अप करो और मुझे सत्यापन कोड बताओ।"

Temp mail API के अक्सर पूछे जाने वाले प्रश्न

एक मेलबॉक्स किसे माना जाता है?

आपके द्वारा बनाया गया हर नया पता मौजूदा 30-दिन के चक्र के कोटे से एक मेलबॉक्स लेता है। सूचीबद्ध करने, पढ़ने और हटाने से मेलबॉक्स नहीं लगते, और पता हटाने पर मेलबॉक्स वापस नहीं मिलता।

क्या पते समाप्त हो जाते हैं?

नहीं। कोई पता तब तक आपके खाते में रहता है जब तक आप उसे हटा नहीं देते। उसमें मौजूद संदेश 24 घंटे तक रखे जाते हैं।

क्या मैं ईमेल भेज सकता हूँ या अटैचमेंट प्राप्त कर सकता हूँ?

नहीं। API केवल प्राप्त करने के लिए है और अटैचमेंट डिलीवर नहीं होते।

क्या मैं पते का नाम और डोमेन चुन सकता हूँ?

हमारे साझा डोमेन पर नाम यादृच्छिक होता है। नाम चुनने के लिए, API प्लेटफ़ॉर्म पर अपना डोमेन जोड़ें और उसका MX रिकॉर्ड हमारी ओर इंगित करके उसे सत्यापित करें, फिर नामकरण नियमों के अनुरूप कस्टम नाम वाले पते बनाएँ।

क्या मुझे IP अनुमति सूची की आवश्यकता है?

केवल मुफ़्त प्लान पर, जहाँ आप वह एक IP पता जोड़ते हैं जिससे आपका सर्वर कॉल करता है। एक IP पता केवल एक ही मुफ़्त खाते का हो सकता है, इसलिए साझा कार्यालय या VPN पता पहले से उपयोग में हो सकता है। सक्रिय सशुल्क प्लान के साथ, API किसी भी IP पते से अनुरोध स्वीकार करता है।

क्या API मेरे लिए सत्यापन कोड पढ़ता है?

हाँ, यथासंभव प्रयास के आधार पर। जब आप कोई संदेश पढ़ते हैं, तो प्रतिक्रिया में उसे मिला वन-टाइम कोड (या जब वह निश्चित न हो तो null), अन्य कोड जैसे मान और लिंक शामिल होते हैं। अपने परीक्षण में हमेशा मान की जाँच करें।

क्या Claude या ChatGPT जैसे AI एजेंट API का उपयोग कर सकते हैं?

हाँ, MCP के माध्यम से। सशुल्क प्लान पर, होस्ट किए गए सर्वर https://mcp.tmailor.com/mcp को अपने AI ऐप में जोड़ें और एक्सेस स्वीकृत करें, या अपनी API कुंजी भेजें। किसी भी प्लान पर, आप अपने कंप्यूटर पर ओपन-सोर्स tmailor-mcp सर्वर चला सकते हैं। दोनों ही तरह से, एजेंट एक पता बना सकता है, ईमेल की प्रतीक्षा कर सकता है और वन-टाइम कोड पढ़ सकता है, और वह API के समान मेलबॉक्स कोटा का उपयोग करता है।

क्या सशुल्क प्लान पर अनुरोध की सीमा है?

सशुल्क प्लान पर कोई दैनिक या मासिक अनुरोध कोटा नहीं होता, लेकिन हर प्लान की प्रति मिनट दर सीमा होती है। Free प्लान पर दैनिक अनुरोध की सीमा भी होती है।

क्या शुरू करने के लिए मुझे क्रेडिट कार्ड की आवश्यकता है?

नहीं। अपने tmailor.com खाते या Google से साइन इन करें, एक key बनाएँ और मुफ़्त प्लान पर शुरू करें। भुगतान केवल तब करना होता है जब आप सशुल्क प्लान चुनते हैं।

मैं किसी प्लान का भुगतान कैसे कर सकता हूँ?

TRC20 (Tron) या BEP20 (BNB Smart Chain) नेटवर्क पर USDT से, या Binance Pay से भुगतान करें। क्रेडिट और डेबिट कार्ड स्वीकार नहीं किए जाते। भुगतान की पुष्टि होते ही आपका प्लान सक्रिय हो जाता है, आमतौर पर कुछ ही मिनटों में।

क्या मुझे धनवापसी मिल सकती है?

नहीं। भुगतान वापस नहीं होते, इसलिए अपग्रेड करने से पहले Free प्लान पर अपने इंटीग्रेशन का परीक्षण करें।

API का उपयोग किन कामों के लिए अनुमत नहीं है?

स्पैम, धोखाधड़ी, अन्य सेवाओं पर थोक में खाते बनाना और उनके प्रतिबंधों या सीमाओं से बचना API की शर्तों का उल्लंघन है। ऐसा करने वाले खातों की API कुंजियाँ हम रद्द कर सकते हैं और उन्हें लॉक कर सकते हैं।

मिनटों में अपना पहला पता बनाएं

मुफ़्त योजना पर शुरुआत करें, जिसमें हर महीने 100 मेलबॉक्स मिलते हैं। क्रेडिट कार्ड की ज़रूरत नहीं।

मुफ़्त शुरू करें API दस्तावेज़ पढ़ें

टेस्टिंग और ऑटोमेशन के लिए Temp Mail API

प्रति मेलबॉक्स भुगतान करें, प्रति अनुरोध नहीं

API कुंजी से इनबॉक्स तक चार चरणों में

API कुंजी बनाएँ

पता बनाएँ

संदेश पढ़ें

इसे रखें या हटाएँ

दोहराने योग्य ईमेल वर्कफ़्लो के लिए बनाया गया

साइन-अप और OTP परीक्षण

CI/CD पाइपलाइन

QA और स्टेजिंग

अपने स्वयं के डोमेन पर पते

प्लान और मूल्य

मुफ़्त

स्टार्टर

प्रो

बिज़नेस

Scale

Enterprise

योजनाओं की तुलना करें

हर योजना में शामिल

आधिकारिक SDK और CLI

Python

Node.js

PHP

AI एजेंट के लिए MCP सर्वर

होस्टेड सर्वर

स्थानीय सर्वर

Temp mail API के अक्सर पूछे जाने वाले प्रश्न

मिनटों में अपना पहला पता बनाएं