शुरुआत: अपनी API कुंजी प्राप्त करना
EvilMail API का उपयोग शुरू करने के लिए, आपको एक API कुंजी जनरेट करनी होगी। EvilMail डैशबोर्ड में Settings > API > Generate New Key पर जाएँ। अपनी कुंजी सुरक्षित स्थान पर रखें — यह दोबारा नहीं दिखाई जाएगी।
API के सभी अनुरोधों में प्रमाणीकरण हेडर शामिल होना चाहिए:
Authorization: Bearer YOUR_API_KEYअस्थायी ईमेल बनाना
डिस्पोजेबल ईमेल बनाने के लिए मुख्य endpoint है:
curl -X POST https://evilmail.com/api/temp-email
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{"domain": "evilmail.com", "prefix": "my-test"}'रिस्पॉन्स:
{
"email": "[email protected]",
"created_at": "2026-03-12T10:00:00Z",
"expires_at": "2026-03-13T10:00:00Z"
}prefix फ़ील्ड वैकल्पिक है। यदि छोड़ दिया जाए, तो एक रैंडम एड्रेस जनरेट होगा।
इनबॉक्स क्वेरी करना
किसी एड्रेस पर प्राप्त ईमेल जाँचने के लिए:
curl -X GET https://evilmail.com/api/inbox/[email protected]
-H "Authorization: Bearer YOUR_API_KEY"रिस्पॉन्स:
{
"email": "[email protected]",
"messages": [
{
"id": "msg_abc123",
"from": "[email protected]",
"subject": "Confirm your registration",
"body": "Click the link to verify...",
"received_at": "2026-03-12T10:05:00Z"
}
]
}डोमेन प्रबंधित करना
यदि आपके पास कस्टम डोमेन कॉन्फ़िगर है, तो आप उपलब्ध डोमेन सूचीबद्ध कर सकते हैं:
curl -X GET https://evilmail.com/api/domains
-H "Authorization: Bearer YOUR_API_KEY"रिस्पॉन्स:
{
"domains": [
{"domain": "evilmail.com", "type": "shared"},
{"domain": "mydomain.com", "type": "custom", "verified": true}
]
}कस्टम डोमेन के साथ, आप अपने स्वयं के डोमेन का उपयोग करके अस्थायी ईमेल बना सकते हैं:
curl -X POST https://evilmail.com/api/temp-email
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{"domain": "mydomain.com", "prefix": "support"}'उपयोग के मामले
स्वचालित परीक्षण
वास्तविक इनबॉक्स पर निर्भर हुए बिना साइनअप फ़्लो, पासवर्ड रिकवरी और ईमेल नोटिफ़िकेशन टेस्ट करने के लिए API को अपनी CI/CD पाइपलाइन में इंटीग्रेट करें।
सेवा अलगाव
आप जिस भी सेवा में साइनअप करें, उसके लिए एक यूनिक डिस्पोजेबल ईमेल बनाएँ। यदि कोई एक सेवा हैक होती है, तो बाकी सुरक्षित रहती हैं।
तेज़ प्रोटोटाइपिंग
डेवलपमेंट के दौरान, ईमेल सर्वर कॉन्फ़िगर करने की ज़रूरत के बिना तेज़ी से टेस्ट एड्रेस जनरेट करने के लिए API का उपयोग करें।
सेवा मॉनिटरिंग
ऐसे एड्रेस बनाएँ जो अलर्ट और नोटिफ़िकेशन प्राप्त करें, और API के ज़रिए प्रोग्रामेटिक रूप से डिलीवरी मॉनिटर करें।
सीमाएँ और सर्वोत्तम अभ्यास
- Rate limiting: प्रति API कुंजी प्रति मिनट 100 अनुरोध
- समाप्ति: अस्थायी ईमेल डिफ़ॉल्ट रूप से 24 घंटे में समाप्त होते हैं (कॉन्फ़िगर करने योग्य)
- आकार: 25 MB तक के संदेश समर्थित हैं
- अपनी API कुंजी सुरक्षित रूप से स्टोर करें — इसे कभी क्लाइंट-साइड कोड में एक्सपोज़ न करें
- त्रुटि हैंडलिंग लागू करें 429 (rate limit) और 5xx (सर्वर त्रुटि) रिस्पॉन्स के लिए