आपको डिस्पोजेबल जीमेल-शैली के पते चाहिए जिन्हें आप मांग पर उत्पन्न कर सकते हैं, परीक्षणों, साइन-अप प्रवाह, या QA स्क्रिप्ट में डाल सकते हैं, और आपको यह इस सप्ताह चाहिए। इस लेख के अंत तक आप एक अस्थायी जीमेल पता उत्पन्न करने में सक्षम होंगे, 500 अद्वितीय पते तक बल्क-उत्पन्न करेंगे जिनमें डॉट/प्लस नियम होंगे, और एक दिए गए पते के लिए इनबॉक्स गतिविधि की जांच करेंगे—ज़ाइला एपीआई हब से एक एपीआई कुंजी का उपयोग करके।
यह एपीआई क्या करता है और इसका उपयोग कब करें
अस्थायी जीमेल एपीआई अस्थायी जीमेल-संगत पते के प्रोग्रामेटिक उत्पन्न करने और सत्यापन जांच के लिए हाल की इनबॉक्स गतिविधि की जांच करने का एक तरीका प्रदान करता है। सामान्य उपयोग के मामले शामिल हैं:
- एंड-टू-एंड परीक्षण जो प्रत्येक रन पर अद्वितीय जीमेल-फॉर्मेटेड पते की आवश्यकता होती है।
- वास्तविक, डिलीवर करने योग्य-शैली के ईमेल के साथ डेमो वातावरण को सीड करना।
- डॉट-और-प्लस पते के व्यवहार का परीक्षण करने के लिए समानांतर साइन-अप प्रवाह बनाना।
- स्टेजिंग में सत्यापन चरणों के लिए हाल की गतिविधि की जांच करना।
एपीआई ज़ाइला एपीआई हब पर चलता है, इसलिए आप एकल एपीआई कुंजी, सुसंगत प्राधिकरण हेडर, और पूरे मार्केटप्लेस में एक सदस्यता + कोटा मॉडल का उपयोग करते हैं।
ज़ाइला एपीआई हब पर शुरू करना
ज़ाइला पर अस्थायी जीमेल एपीआई पृष्ठ खोलें, सदस्यता लें, और अपनी कुंजी प्राप्त करें। प्रमाणीकरण एक मानक बियरर टोकन है।
- मार्केटप्लेस लिस्टिंग पर जाएं: अस्थायी जीमेल एपीआई पर 7-दिन की परीक्षण अवधि शुरू करें.
- अपनी कुंजी प्राप्त करने के लिए सदस्यता लें (या उपलब्ध होने पर मुफ्त परीक्षण शुरू करें)।
- अनुरोध भेजें: प्राधिकरण: बियरर YOUR_API_KEY।
ज़ाइला सदस्यता + कोटा का उपयोग करता है (पे-पर-कॉल नहीं)। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए एपीआई पृष्ठ की जांच करें। आपकी कुंजी ज़ाइला एपीआई हब पर 10,000 से अधिक सार्वजनिक एपीआई पर काम करती है।
आप जिन एंडपॉइंट्स का उपयोग करेंगे
नीचे सभी एंडपॉइंट्स ज़ाइला के हब यूआरएल पर HTTP GET हैं और प्राधिकरण हेडर की आवश्यकता होती है। केवल प्रलेखित पैरामीटर भेजे जाने चाहिए।
1) जीमेल उत्पन्न करें
एक अस्थायी जीमेल पता उत्पन्न करता है।
- विधि: GET
- यूआरएल: https://zylalabs.com/api/8382/temporary-gmail-api/14645/generate-gmail
- आवश्यक पैरामीटर:
- डोमेन (स्ट्रिंग): रैंडम
cURL (कॉपी-पेस्ट के लिए तैयार):
curl -s -X GET "https://zylalabs.com/api/8382/temporary-gmail-api/14645/generate-gmail?domain=random"
-H "Authorization: Bearer YOUR_API_KEY"
उदाहरण JSON प्रतिक्रिया:
{
"email": "[email protected]"
}
आप जिन फ़ील्ड्स का वास्तव में उपयोग करेंगे:
- ईमेल: उत्पन्न किया गया जीमेल-शैली का पता जिसे आप तुरंत साइनअप या परीक्षण प्रवाह में डाल सकते हैं।
2) बल्क जीमेल
वैकल्पिक डॉट/प्लस/डोमेन फ़िल्टर के साथ 500 अद्वितीय अस्थायी ईमेल उत्पन्न करता है।
- विधि: GET
- यूआरएल: https://zylalabs.com/api/8382/temporary-gmail-api/14647/bulk-gmail
- पैरामीटर:
- डॉट (स्ट्रिंग, वैकल्पिक): सही
- प्लस (स्ट्रिंग, आवश्यक): गलत
cURL:
उदाहरण JSON प्रतिक्रिया:
नोट्स:
- गिनती: इस बैच में लौटाए गए ईमेल की संख्या।
- ईमेल: अद्वितीय जीमेल/गूगलमेल रूपांतरों की सूची। डॉट और, आपके पैरामीटर के आधार पर, प्लस पते लागू किए जा सकते हैं।
3) इनबॉक्स
एक निर्दिष्ट पते के लिए हाल की गतिविधि प्राप्त करता है, जिसमें यह कब क्वेरी किया गया, प्रतिक्रिया समय, कितने परिणाम पाए गए, और सत्यापन के लिए कोई उपलब्ध संदेश शामिल हैं।
- विधि: GET
- यूआरएल: https://zylalabs.com/api/8382/temporary-gmail-api/14648/inbox
- पैरामीटर:
- ईमेल (स्ट्रिंग, आवश्यक): [email protected]
cURL:
उदाहरण JSON प्रतिक्रिया:
नोट्स:
- ईमेल: वह पता जिस पर यह गतिविधि संबंधित है।
- queried_at: उस समय का टाइमस्टैम्प स्ट्रिंग जब इनबॉक्स की जांच की गई (API द्वारा समय क्षेत्र निर्दिष्ट नहीं किया गया)।
- response_time: एपीआई की प्रोसेसिंग समय के लिए अवधि स्ट्रिंग।
- गिनती: इस परिणाम में उपलब्ध संदेशों की संख्या।
- संदेश: संदेशों की सूची; इस उदाहरण में खाली।
त्वरित प्रारंभ: एक फेंकने योग्य जीमेल उत्पन्न करें और इसका उपयोग परीक्षणों में करें
सबसे तेज़ रास्ते के लिए, जीमेल उत्पन्न करें, ईमेल को अपने परीक्षण संदर्भ में स्टैश करें, फिर अपना प्रवाह चलाएँ।
पायथन उदाहरण (अनुरोध)
यह उदाहरण जीमेल उत्पन्न करने के एंडपॉइंट को हिट करता है, ईमेल मान को निकालता है, और इसे डाउनस्ट्रीम चरणों में उपयोग के लिए प्रिंट करता है।
import os
import requests
API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
url = "https://zylalabs.com/api/8382/temporary-gmail-api/14645/generate-gmail"
params = {"domain": "random"}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, params=params, headers=headers, timeout=30)
resp.raise_for_status()
data = resp.json()
email = data.get("email")
print(f"Generated temp Gmail: {email}")
# उदाहरण: इसे अपने साइनअप पेलोड या परीक्षण रनर में पास करें
# signup(user_email=email)
प्रतिक्रिया का अपेक्षित आकार ऊपर दिए गए आधिकारिक नमूने के समान है; data["email"] की जांच करें और उस पते को अपने स्वचालन में डालें।
व्यावहारिक कार्यान्वयन नोट्स
- प्राधिकरण: हमेशा प्राधिकरण: बियरर YOUR_API_KEY भेजें।
- टाइमआउट: परीक्षण चलाने को पूर्वानुमानित रखने के लिए एक क्लाइंट टाइमआउट (जैसे, 30 सेकंड) सेट करें।
- इडेम्पोटेंसी: उत्पन्न करने वाले एंडपॉइंट प्रत्येक कॉल पर नए रूपांतर बनाते हैं; यदि आपको पुनरावृत्त रन की आवश्यकता है तो चुने हुए पते को बनाए रखें।
- डॉट और प्लस सेमांटिक्स: बल्क जीमेल एंडपॉइंट अपने प्रलेखित पैरामीटर के माध्यम से डॉट और प्लस नियंत्रण की अनुमति देता है। डॉट=true का उपयोग करें ताकि डॉटेड रूपांतर प्राप्त करें और प्लस=false का उपयोग करें ताकि प्लस पते से बचें।
- इनबॉक्स टाइमस्टैम्प: queried_at एक स्ट्रिंग के रूप में लौटाया जाता है; API द्वारा कोई समय क्षेत्र निर्दिष्ट नहीं किया गया है। इसे जैसा है वैसा ही स्टोर करें या ऑडिट के लिए अपने सिस्टम समय के साथ एनोटेट करें।
- कैशिंग और पेजिनेशन: इन एंडपॉइंट्स के लिए निर्दिष्ट नहीं किया गया है। यदि आप इनबॉक्स के लिए एक पोलर बना रहे हैं, तो बैकऑफ लागू करें और अनावश्यक पुनरावृत्त कॉल से बचें।
- कोटा: ज़ाइला सदस्यता + कोटा का उपयोग करता है। अपने कॉल वॉल्यूम की निगरानी करें और सीमाओं और वर्तमान पहुंच विकल्पों के लिए मार्केटप्लेस लिस्टिंग की जांच करें।
कार्यप्रवाह व्यंजनों
1) एक बार का साइनअप परीक्षण
- डोमेन=random के साथ जीमेल उत्पन्न करें।
- अपने साइनअप फॉर्म में लौटाए गए ईमेल का उपयोग करें।
- वैकल्पिक रूप से इनबॉक्स को यह सत्यापित करने के लिए पोल करें कि कोई संदेश उपलब्ध हो गया है, यदि आपका कार्यप्रवाह प्राप्ति जांच पर निर्भर करता है।
2) विविध पते के साथ लोड परीक्षण साइनअप
- डॉट=true&प्लस=false के साथ बल्क जीमेल कॉल करें ताकि रूपांतरों का एक बैच प्राप्त किया जा सके।
- संघर्ष से बचने के लिए अपने श्रमिकों के बीच पते का वितरण करें।
- पुनरुत्पादकता के लिए रिकॉर्ड करें कि कौन सा पता किस परीक्षण मामले से संबंधित है।
3) स्टेजिंग पर ईमेल सत्यापन QA
- प्रत्येक रन के लिए एक अद्वितीय पता प्रदान करें (जीमेल उत्पन्न करें)।
- अपने सिस्टम को सत्यापन संदेश भेजने के लिए ट्रिगर करें।
- उस पते के लिए इनबॉक्स कॉल करें और queried_at, response_time, और किसी भी संदेश को स्टोर करें जिसकी आपको मान्यता के लिए आवश्यकता है।
AI एजेंटों द्वारा MCP के माध्यम से एपीआई कॉल करना
यदि आप एक MCP-संगत क्लाइंट (जैसे, क्लॉड कोड, कर्सर, विंडसर्फ) में प्रवाह का आयोजन करते हैं, तो आप MCP गेटवे के माध्यम से ज़ाइला एपीआई को कॉल कर सकते हैं। एंडपॉइंट का उपयोग करें:
जब MCP टूल यूआरएल को कॉन्फ़िगर करते हैं (जैसे, https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY) तो अपनी कुंजी को क्वेरी स्ट्रिंग में apikey=YOUR_API_KEY के रूप में प्रदान करें। फिर अपने एजेंट से अस्थायी जीमेल एपीआई क्रियाएँ लागू करें। सटीक टूल कॉन्फ़िगरेशन आपके क्लाइंट पर निर्भर करता है; अपने MCP क्लाइंट के दस्तावेज़ों का संदर्भ लें और जब टूल कॉल को अग्रेषित करता है तो ऊपर दिखाए गए समान प्राधिकरण मॉडल और पैरामीटर बनाए रखें।
समस्या निवारण टिप्स
- 401 या 403: पुष्टि करें कि आप प्राधिकरण: बियरर YOUR_API_KEY भेज रहे हैं और कुंजी लिस्टिंग पर सक्रिय है।
- खाली इनबॉक्स: संदेशों का अनुपस्थित होना मान्य है; सत्यापित करें कि आपका अपस्ट्रीम सिस्टम वास्तव में ईमेल भेजता है और विफलता का निष्कर्ष निकालने से पहले पुनः प्रयास/बैकऑफ पर विचार करें।
- बल्क जीमेल में अप्रत्याशित गिनती: एपीआई 500 तक लौटाता है; सटीक गिनती भिन्न हो सकती है। गिनती फ़ील्ड पढ़ें और ईमेल के अनुसार पुनरावृत्त करें।
- प्लस पते को एन्कोड करना: जब इनबॉक्स एंडपॉइंट को ईमेल पास करते हैं, तो + और @ जैसे वर्णों को नमूने में दिखाए अनुसार URL-एन्कोड करें।
कॉपी-रेडी अनुरोध
एक जीमेल उत्पन्न करें
बल्क जीमेल रूपांतर (डॉट चालू, प्लस बंद)
एक विशिष्ट पते के लिए इनबॉक्स गतिविधि की जांच करें
अक्सर पूछे जाने वाले प्रश्न
मुझे कौन सा प्राधिकरण हेडर चाहिए?
हर अनुरोध पर प्राधिकरण: बियरर YOUR_API_KEY भेजें।
क्या मैं एक बार में कितने ईमेल प्राप्त कर सकता हूँ?
एक ही कॉल में 500 अद्वितीय ईमेल उत्पन्न करने के लिए बल्क जीमेल एंडपॉइंट का उपयोग करें, आपकी सदस्यता कोटा के अधीन।
क्या इनबॉक्स एंडपॉइंट पूर्ण संदेश सामग्री लौटाता है?
इनबॉक्स एंडपॉइंट हाल की गतिविधि फ़ील्ड और सत्यापन के लिए उपलब्ध संदेश लौटाता है। आपके द्वारा देखे जाने वाले सटीक फ़ील्ड यहाँ प्रलेखित नहीं हैं; यदि मौजूद हो तो संदेशों की सूची को संसाधित करें।
क्या डॉट और प्लस पते का समर्थन किया जाता है?
बल्क जीमेल डॉट और प्लस नियमों का समर्थन करता है। रूपांतरों को नियंत्रित करने के लिए डॉट=true और प्लस=false का उपयोग करें।
क्या कोई मुफ्त योजना है?
ज़ाइला सदस्यता + कोटा मॉडल का उपयोग करता है। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए मार्केटप्लेस लिस्टिंग की जांच करें, जिसमें उपलब्ध परीक्षण शामिल है।
क्या आप इसे अपने पाइपलाइन में जोड़ने के लिए तैयार हैं? अपनी एपीआई कुंजी बनाएं और आज अपनी एकीकरण को शिप करें: अस्थायी जीमेल एपीआई पर 7-दिन की परीक्षण अवधि शुरू करें. ज़ाइला एपीआई हब पर हजारों और तैयार-से-उपयोग सेवाओं का अन्वेषण करें, सभी एकल कुंजी के साथ।