Run2Mail に対してビルドする

Developer API Documentation

Learn how to create API keys, authenticate requests, create inboxes, fetch messages, and handle common Run2Mail API responses.

APIキー認証コアエンドポイントエラーコード

APIキー

ダッシュボードから開発者 API キーを生成します。各キーは一度だけ完全に表示され、その後は将来の検証のために安全なハッシュとして保存されます。

ログインしたダッシュボードからキーを作成します。
キーを非公開にして、独自のシークレットマネージャーに保存します。
デバイス、スクリプト、またはチームメイトがアクセスする必要がなくなった場合は、古いキーを取り消します。

認証

すべての保護されたリクエストの Authorization ヘッダーで Bearer トークンを使用します。

Authorization: Bearer YOUR_API_KEY

キーが無効、取り消されている、または見つからない場合、API は認証エラーで応答します。

コアエンドポイント

最も一般的なワークフローは、認証されたユーザーを検査し、受信箱を作成し、その受信箱からメッセージを取得することです。

現在のアカウントを確認する

curl -X GET "https://run2mail.com/api/v1/me" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

受信箱を作成する

curl -X POST "https://run2mail.com/api/v1/emails/create" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "random"
  }'

受信箱メッセージを取得する

curl -X GET "https://run2mail.com/api/v1/emails/example@2mail.lol/messages" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

JSON 応答のサンプル

{
  "success": true,
  "data": {
    "email": "example@2mail.lol",
    "messages": []
  }
}

レート制限

Run2Mail は、サービスを保護し、API アクセスの安定性を維持するために、プランベースのリクエスト制限と毎日の受信トレイ作成制限を適用します。

分あたりのレート制限は、アクティブなプランによって異なります。
電子メール作成の制限は、基本的な読み取り呼び出しとは別に追跡されます。
使用状況は管理分析ダッシュボード内で確認できるようにログに記録されます。

エラーコード

401: API 資格情報が欠落しているか無効です。
403: リクエストに対するアクセスがブロック、制限されているか、許可されていません。
429: リクエスト量が現在の制限を超えました。
503: 開発者 API がプラットフォームによって一時的に無効になっています。

ダッシュボード API のスクリーンショットは近日公開予定です

この領域は、API キーマネージャーと使用状況ダッシュボードの今後のスクリーンショット用に予約されています。