Tài liệu API

Khi không mang theo Key, bạn có thể gọi điện một cách ẩn danh, và việc tạo/đọc email tạm thời là hoàn toàn miễn phí. Nếu bạn đã mua gói dịch vụ bao gồm chức năng API, bạn có thể tự tạo Key tại trung tâm thành viên → Chức năng API dành cho nhà phát triển. Sử dụng Key này để gọi điện sẽ được hưởng các ưu đãi như quỹ bảo mật và thời hạn lưu trữ mà gói dịch vụ đó cung cấp.

Cách mang theo (chọn một trong hai cách sau):

Yêu cầu ví dụ

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

Tạo một địa chỉ email tạm thời ngẫu nhiên. Sau khi địa chỉ được tạo ra, bạn có thể nhận thư mà không cần phải kích hoạt trước.

Thông số yêu cầu

Yêu cầu ví dụ

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

Ví dụ về phản ứng

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

Hãy kích hoạt một địa chỉ có tiền tố tùy chỉnh (dạng tiền tố@tên miền), sau đó kiểm tra xem tên miền đó có thể được sử dụng để gửi email hay không.

Thông số yêu cầu

Yêu cầu ví dụ

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

Ví dụ về phản ứng

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

Lấy dữ liệu từ địa chỉ được chỉ định vào hộp thư của bạn (50 lá thư gần nhất, theo thứ tự ngược về thời gian nhận tin). Đề nghị thực hiện việc kiểm tra mỗi 1–3 giây.

Thông số yêu cầu

Yêu cầu ví dụ

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

Ví dụ về phản ứng

{
  "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"
    }
  ]
}

Xem thông tin chi tiết về email (người gửi, tiêu đề, nội dung, danh sách tài liệu kèm theo). Sau khi xem xong, email sẽ được đánh dấu là đã đọc.

Thông số yêu cầu

Yêu cầu ví dụ

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

Ví dụ về phản ứng

{
  "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 }
    ]
  }
}

Tải về tập tin đính kèm trong email (trực tiếp nhận được dữ liệu, không phải dạng JSON).

Thông số yêu cầu

Yêu cầu ví dụ

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

Hãy lưu trữ một địa chỉ vào tài khoản của bạn để giữ lại trong thời gian dài (cần đăng nhập hoặc mang theo Chìa khóa API). Số lượng địa chỉ có thể lưu trữ bị giới hạn bởi mức độ hỗ trợ của gói dịch vụ “Khả năng lưu trữ email”.

Thông số yêu cầu

Yêu cầu ví dụ

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

Hãy liệt kê các địa chỉ email đã được lưu trữ trong tài khoản của bạn (cần đăng nhập hoặc có API Key để truy cập).

Yêu cầu ví dụ

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

Đoạn mã dưới đây có thể được chạy trực tiếp trong bảng điều khiển của trình duyệt hoặc trong môi trường Node: tạo địa chỉ email, kiểm tra hộp thư nhận tin, in mã xác thực ngay khi nhận được email đầu tiên.

// 1. Tạo một địa chỉ tạm thời
const BASE = 'https://www.mail0.vip';
const gen = await (await fetch(BASE + '/mail/gen')).json();
const address = gen.address;
console.log('Email tạm thời của tôi:', address);

// 2. Làm việc theo chu kỳ: Mỗi 2 giây một lần, dừng lại khi nhận được email đầu tiên
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('Thư mới:', m.subject, code ? 'mã xác minh (captcha) ' + code[0] : '');
  }
  await new Promise(r => setTimeout(r, 2000));
}