開発者向け
MaileraのREST APIで開発。
Microsoftメールボックスのインポート、メールの閲覧・送信、迷惑メールからの移動、署名付きwebhookの受信ができます。
curl https://mailera.app/api/public/v1/mailboxes \ -H "X-API-Key: mh_live_..."クイックスタート
- 1
API keyを作成
無料登録後、設定 → API keyに移動し、キーの権限を選択します。
- 2
メールボックスをインポート
メールボックスの一覧をインポート用エンドポイントに送信し、行ごとの結果を確認します。
- 3
閲覧と送信
フォルダーごとにメールを取得し、OTPコードの読み取りやメールの送信・返信ができます。
エンドポイントグループ
メールボックス
メールボックスのインポート、稼働状況の確認、同期、一時停止、削除ができます。
エンドポイントを見るメール
一覧取得、閲覧、検索、OTPコードの抽出、送信、返信、転送ができます。
エンドポイントを見る迷惑メール
メールが受信トレイと迷惑メールのどちらに届いたかを確認し、迷惑メールから移動できます。
エンドポイントを見るwebhook
新着メール、迷惑メールへの振り分け、メールボックスの接続切断のイベントを購読できます。
エンドポイントを見る
API keyの権限
各キーで実行できるのは、許可した操作だけです。
| スコープ | 許可される操作 |
|---|---|
read | メールボックス、メール、OTP コード、受信トレイ/迷惑メールへの振り分け結果の取得 |
move | 迷惑メールからの移動とフォルダー間のメール移動 |
import | メールボックスの追加 |
sync | 即時同期のリクエスト |
send | メールの送信、返信、転送 |
manage | メールボックスの一時停止、再開、削除 |
webhooks | webhook の管理 |
webhook
メールが届くとすぐにイベントを受信できます。
Maileraは指定のURLにPOSTリクエストを送信します。X‑MailHub‑SignatureヘッダーにHMAC-SHA256署名を付け、エンドポイントでエラーが発生した場合は自動で再試行します。
message.received受信トレイに新着メールが届いたときmessage.junk迷惑メールに新着メールが届いたときmailbox.disconnectedメールボックスの接続が切れたとき(token の失効、パスワードの変更など)
制限と詳細
- レート制限
- キーごとに毎分300リクエスト
- 認証
- X-API-Keyヘッダー
- 無料ワークスペースあたりのメールボックス数
- 最大1,000件のメールボックス
- ページネーション
- cursorとnext_cursor
- 機械可読形式の仕様
- OpenAPI 3.1 · llms.txt

