EvilMail API সারসংক্ষেপ
EvilMail প্রোগ্রামের মাধ্যমে ডিসপোজেবল ইমেইল পরিচালনার জন্য একটি ব্যাপক REST API প্রদান করে। এই API সব request ও response body-তে JSON ব্যবহার করে এবং API key দিয়ে authentication সমর্থন করে।
Authentication
প্রতিটি request-এ header-এ API key থাকতে হবে:
curl -H "Authorization: Bearer YOUR_API_KEY"
https://api.evilmail.com/v1/inboxesআপনি EvilMail ড্যাশবোর্ডে Settings > API Keys থেকে API key তৈরি করতে পারেন।
ইনবক্স তৈরি
নতুন ইনবক্স তৈরি করতে POST /v1/inboxes endpoint ব্যবহার করুন:
curl -X POST
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{"prefix": "test", "domain": "yourdomain.com", "ttl": 3600}'
https://api.evilmail.com/v1/inboxesResponse-এ তৈরি ইনবক্সের id, email এবং expires_at থাকবে।
বার্তা পড়া
GET /v1/inboxes/{id}/messages দিয়ে ইনবক্সের সব বার্তা পড়ুন:
curl -H "Authorization: Bearer YOUR_API_KEY"
https://api.evilmail.com/v1/inboxes/INBOX_ID/messagesWebhooks
নতুন বার্তার জন্য poll করার বদলে, নতুন ইমেইল আসলে EvilMail আপনার অ্যাপ্লিকেশনে notification পাঠাতে webhook সেটআপ করতে পারেন। POST /v1/webhooks দিয়ে webhook তৈরি করুন:
curl -X POST
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{"url": "https://yourapp.com/webhook/email", "events": ["message.received"]}'
https://api.evilmail.com/v1/webhooksRate Limits ও Best Practices
API-তে ফ্রি প্ল্যানে প্রতি মিনিটে ১০০ requests এবং পেইড প্ল্যানে প্রতি মিনিটে ১,০০০ requests-এর rate limit আছে। সম্ভব হলে polling-এর বদলে webhook ব্যবহার করুন, অপরিবর্তনীয় response ক্যাশে করুন এবং HTTP 429 exponential backoff দিয়ে হ্যান্ডেল করুন।
উপসংহার
EvilMail API আপনার অ্যাপ্লিকেশনে ডিসপোজেবল ইমেইল কার্যকারিতা সংহত করতে উচ্চ নমনীয়তা প্রদান করে। স্বয়ংক্রিয় পরীক্ষা, অস্থায়ী ইমেইল প্রয়োজন এমন সেবা তৈরি বা বড় আকারে ইমেইল পরিচালনা — সবকিছুর জন্য এটি কাজ করে।