はじめに
EvilMailのREST APIを使えば、使い捨てメール機能をあらゆるアプリケーションに組み込めます。メールボックスの作成からメッセージの取得まで、すべてをプログラムで制御できます。
認証
すべてのAPIリクエストにはBearerトークンが必要です。ダッシュボードの「API設定」セクションでAPIキーを生成してください。
curl -H "Authorization: Bearer YOUR_API_KEY"
https://api.evilmail.com/v1/mailboxes主要エンドポイント
メールボックス管理
# メールボックスの作成
curl -X POST https://api.evilmail.com/v1/mailboxes
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{"domain": "evilmail.com", "prefix": "test-user"}'
# メールボックス一覧の取得
curl https://api.evilmail.com/v1/mailboxes
-H "Authorization: Bearer YOUR_API_KEY"
# メールボックスの削除
curl -X DELETE https://api.evilmail.com/v1/mailboxes/{id}
-H "Authorization: Bearer YOUR_API_KEY"メッセージ操作
# メッセージ一覧の取得
curl https://api.evilmail.com/v1/mailboxes/{id}/messages
-H "Authorization: Bearer YOUR_API_KEY"
# メッセージ詳細の取得
curl https://api.evilmail.com/v1/messages/{message_id}
-H "Authorization: Bearer YOUR_API_KEY"
# 添付ファイルのダウンロード
curl https://api.evilmail.com/v1/messages/{message_id}/attachments/{attachment_id}
-H "Authorization: Bearer YOUR_API_KEY" -o attachment.pdfレスポンス形式
すべてのレスポンスはJSON形式で返されます。成功時のステータスコードは200（取得）、201（作成）、204（削除）です。
{
"id": "mb_abc123",
"address": "[email protected]",
"created_at": "2026-01-15T10:30:00Z",
"expires_at": "2026-01-16T10:30:00Z",
"message_count": 3
}エラーハンドリング
エラー時には適切なHTTPステータスコードとエラーメッセージが返されます：
- 401 Unauthorized — APIキーが無効または欠落
- 404 Not Found — リソースが存在しない
- 429 Too Many Requests — レート制限を超過
- 500 Internal Server Error — サーバー内部エラー
Webhookの設定
新着メールをリアルタイムで受け取るには、Webhookを設定します。ダッシュボードまたはAPIでWebhook URLを登録すると、メール受信時にPOSTリクエストが送信されます。
curl -X POST https://api.evilmail.com/v1/webhooks
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{"url": "https://your-app.com/webhook/email", "events": ["message.received"]}'まとめ
EvilMail APIは、RESTful設計に基づいたシンプルで強力なインターフェースを提供します。認証、メールボックス管理、メッセージ操作、Webhookを活用して、アプリケーションに使い捨てメール機能をシームレスに統合しましょう。