APIドキュメント

Keyを持たない場合は、訪問者として匿名で呼び出すことができます。一時的なメールアドレスの生成や読み取りは完全に無料です。API機能が含まれるプランを購入している場合は、会員センター→開発者APIキーから自動的にキーを生成することができます。このキーを使用して呼び出す際には、該当するプランの保存限度額や保持期間を享受できます。

持ち運び方法（2つのうち1つを選択してください）

リクエストの例

curl "https://www.mail0.vip/mail/gen?key=YOUR_API_KEY"

一時的なメールアドレスをランダムに生成します。アドレスが生成されたら、すぐにメールを受け取ることができます。事前のアクティベーションは必要ありません。

リクエストパラメータ

リクエストの例

curl "https://www.mail0.vip/mail/gen?domain=ideciphera.com&ttl=60"

応答例

{
  "code": 1,
  "address": "k3j8fh2ma@ideciphera.com"
}

カスタムプレフィックスを使用したアドレス（プレフィックス@ドメイン名）を設定し、そのドメイン名が受信可能かどうかを確認します。

リクエストパラメータ

リクエストの例

curl -X POST "https://www.mail0.vip/mail/activate" \
  -d "address=mybox@ideciphera.com&ttl=60"

応答例

{
  "code": 1,
  "address": "mybox@ideciphera.com"
}

指定されたアドレスから受信箱を取得します（最も新しい50通、受信時間に応じて逆順で表示されます）。1～3秒ごとにポーリングすることをお勧めします。

リクエストパラメータ

リクエストの例

curl "https://www.mail0.vip/mail/inbox?address=mybox@ideciphera.com"

応答例

{
  "code": 1,
  "exists": 1,
  "address": "mybox@ideciphera.com",
  "list": [
    {
      "id": 1024,
      "from_addr": "noreply@example.com",
      "from_name": "Example",
      "subject": "Your verification code is 826413",
      "size": 2048,
      "is_read": 0,
      "attachments": 0,
      "received_at": "2026-10-14 18:20:31"
    }
  ]
}

メールの詳細を確認します（送信者、件名、本文、添付ファイルのリスト）。確認後、そのメールは「読んだ」とマークされます。

リクエストパラメータ

リクエストの例

curl "https://www.mail0.vip/mail/view?address=mybox@ideciphera.com&id=1024"

応答例

{
  "code": 1,
  "data": {
    "id": 1024,
    "from_addr": "noreply@example.com",
    "from_name": "Example",
    "subject": "Your verification code is 826413",
    "body_text": "Dear user, your verification code is 826413, valid for 5 minutes.",
    "received_at_fmt": "2026-10-14 18:20:31",
    "attachments": [
      { "id": 88, "filename": "invoice.pdf", "size": 102400 }
    ]
  }
}

メールの添付ファイルをダウンロードしてください（直接ファイルストリームとして返信されます。JSON形式ではありません）。

リクエストパラメータ

リクエストの例

curl -O "https://www.mail0.vip/mail/attach?id=88"

アドレスをアカウントに保存し、長期間保持することができます（ログインするか、APIキーを持って行く必要があります）。保存できるアドレスの数は、「保存可能なメールアドレス」の制限により決まります。

リクエストパラメータ

リクエストの例

curl -X POST "https://www.mail0.vip/mail/save" \
  -d "address=mybox@ideciphera.com&key=YOUR_API_KEY"

ご利用のアカウントに保存されているメールアドレスをリストアップしてください（ログインするか、APIキーを携帯してください）。

リクエストの例

curl "https://www.mail0.vip/mail/my?key=YOUR_API_KEY"

以下のスクリプトは、ブラウザのコンソールやNode環境で直接実行できます。アドレスの生成、受信箱のポーリング、最初のメールを受け取ったら認証コードを表示します。

// 1. 一時的なアドレスを生成する
const BASE = 'https://www.mail0.vip';
const gen = await (await fetch(BASE + '/mail/gen')).json();
const address = gen.address;
console.log('私の仮のメールアドレス：', address);

// 2. 受信箱のポーリング（2秒ごとに実行し、最初のメッセージを受け取ったら停止する）
const seen = new Set();
while (true) {
  const d = await (await fetch(BASE + '/mail/inbox?address=' + encodeURIComponent(address))).json();
  for (const m of d.list || []) {
    if (seen.has(m.id)) continue;
    seen.add(m.id);
    const code = (m.subject || '').match(/\d{4,8}/);
    console.log('新しいメール：', m.subject, code ? 'CAPTCHAコード ' + code[0] : '');
  }
  await new Promise(r => setTimeout(r, 2000));
}