ภาพรวม EvilMail API
EvilMail มี REST API ที่ครอบคลุมสำหรับการจัดการอีเมลแบบใช้แล้วทิ้งโดยทางโปรแกรม API นี้ใช้ JSON สำหรับ request และ response bodies ทั้งหมด และรองรับการยืนยันตัวตนด้วย API key
การยืนยันตัวตน
ทุก request ต้องมี API key ใน header:
curl -H "Authorization: Bearer YOUR_API_KEY"
https://api.evilmail.com/v1/inboxesคุณสามารถสร้าง API key ได้จากแดชบอร์ด EvilMail ที่ Settings > API Keys
การสร้างกล่องจดหมาย
ใช้ endpoint POST /v1/inboxes เพื่อสร้างกล่องจดหมายใหม่:
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 หาข้อความใหม่ คุณสามารถตั้งค่า webhook ให้ EvilMail ส่ง notification มาที่แอปพลิเคชันของคุณเมื่อมีอีเมลเข้ามาใหม่ สร้าง webhook ด้วย POST /v1/webhooks:
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 มี rate limit ที่ 100 requests ต่อนาทีสำหรับแผนฟรี และ 1,000 requests ต่อนาทีสำหรับแผนชำระเงิน ใช้ webhook แทน polling เมื่อเป็นไปได้ แคช response ที่ไม่เปลี่ยนแปลง และจัดการ HTTP 429 ด้วย exponential backoff
สรุป
EvilMail API ให้ความยืดหยุ่นสูงในการผสานรวมฟังก์ชันอีเมลแบบใช้แล้วทิ้งเข้ากับแอปพลิเคชันของคุณ ไม่ว่าจะเป็นการทดสอบอัตโนมัติ การสร้างบริการที่ต้องการอีเมลชั่วคราว หรือการจัดการอีเมลขนาดใหญ่