Lấy mail và mã OTP bằng một request

Gọi GET /api/get_mail.php với địa chỉ hộp thư và API key. Kết quả là JSON gồm các mail mới nhất và mã số 5–8 chữ số đã tách sẵn trong trường code.

API key free (dùng chung) Còn 0 lượt hôm nay

YOUR_API_KEY

API key riêng

Key free dùng chung nên có thể hết lượt. Đăng nhập để lấy key riêng và nạp thêm lượt.

Thử ngay

Gửi request thật tới API bằng key free và xem JSON trả về. Gửi một mail tới địa chỉ này rồi bấm lại để thấy mã OTP.

Lấy mail của một hộp thư

Trả về tối đa 10 mail mới nhất gửi tới địa chỉ, kèm mã số tách từ tiêu đề hoặc nội dung.

GET https://ezmail.pro/api/get_mail.php

Tham số

Tên	Mô tả
`email`bắt buộc	Địa chỉ hộp thư, ví dụ `user@ezmail.pro`.
`apikey`bắt buộc	Key free ở trên hoặc key riêng trong phần Cài đặt tài khoản.
`hour`tùy chọn	Chỉ lấy mail trong N giờ gần nhất. `hour=1` là 1 giờ.
`day`tùy chọn	Chỉ lấy mail trong N ngày gần nhất. Bị bỏ qua nếu đã có `hour`.

Kết quả

Trường	Kiểu	Mô tả
`status`	boolean	`true` khi có ít nhất 1 mail. `false` khi hộp thư trống hoặc có lỗi.
`message`	string	Mô tả kết quả hoặc lý do lỗi.
`data[]`	array	Danh sách mail, mới nhất trước.
`data[].code`	string	Mã 5–8 chữ số tách từ tiêu đề (ưu tiên) hoặc nội dung. Rỗng nếu không tìm thấy.
`data[].subject`	string	Tiêu đề mail.
`data[].from_field`	string	Người gửi.
`data[].date`	string	Thời điểm nhận, dạng `YYYY-MM-DD HH:MM:SS` (giờ Việt Nam).
`data[].html_content`	string	Toàn bộ nội dung HTML của mail.
`data[].uid`	string	ID duy nhất của mail.
`data[].status`	string	`unseen` hoặc `seen`.
`remaining_requests`	number	Số lượt còn lại của key sau request này.

Mỗi request có mail trừ 1 lượt của key. Request trả về hộp thư trống không bị trừ lượt, nên có thể gọi lặp lại vài giây một lần để chờ mail.

Ví dụ kết quả

{
  "status": true,
  "message": "Lấy danh sách email thành công",
  "data": [
    {
      "uid": "da1398df-0719-41a9-96db-6e3ca418c0ab",
      "subject": "Mã xác minh của bạn là 359761",
      "from_field": "no-reply@example.com",
      "date": "2026-09-30 17:05:28",
      "html_content": "<!DOCTYPE html>…",
      "status": "unseen",
      "code": "359761"
    }
  ],
  "remaining_requests": 994
}

Lấy danh sách domain

Các domain đang nhận mail được. Truyền API key để lấy thêm domain riêng của bạn.

GET https://ezmail.pro/api/get_domains.php

Tham số

Tên	Mô tả
`api`tùy chọn	API key của bạn. Có key thì kết quả gồm cả domain riêng của bạn, không có thì chỉ domain công khai.

Kết quả

Trường	Kiểu	Mô tả
`data[].domain`	string	Tên domain, dùng làm phần sau `@`.
`data[].type`	string	`public_domain` hoặc `user_domain` (domain riêng của bạn).
`data[].date`	string	Ngày đăng ký domain.
`data[].expiration`	string	Ngày hết hạn domain.
`user`	string \| null	Username của key đã truyền, `null` nếu không truyền.

Chỉ domain đang trỏ MX về server mới có trong danh sách.

Ví dụ kết quả

{
  "status": true,
  "message": "Lấy danh sách domain thành công",
  "data": [
    {
      "domain": "example.com",
      "date": "2025-04-09",
      "expiration": "2026-09-20",
      "user": null,
      "type": "public_domain"
    }
  ],
  "user": null
}

Lỗi thường gặp

Khi lỗi, API trả "status": false và lý do trong message.

message	Nguyên nhân và cách xử lý
`Không tìm thấy email nào`	Hộp thư chưa có mail (trong khoảng `hour`/`day` nếu có). Không bị trừ lượt, chờ vài giây rồi gọi lại.
`API key không hợp lệ`	Sai key hoặc key đã được đổi. Lấy lại key trong Cài đặt tài khoản.
`Số lượt yêu cầu đã hết`	Key đã dùng hết lượt. Key free được nạp lại mỗi ngày; key riêng có thể nạp thêm qua Donate.
`Bạn không có quyền sử dụng email này`	Địa chỉ thuộc domain riêng tư của người khác. Chỉ chủ domain dùng được.

Code mẫu

Chờ mail tới rồi in ra mã OTP. Thay email bằng hộp thư của bạn.

Lấy mail và mã OTP bằng một request

Thử ngay

Lấy mail của một hộp thư

Tham số

Kết quả

Ví dụ kết quả

Lấy danh sách domain

Tham số

Kết quả

Ví dụ kết quả

Lỗi thường gặp

Code mẫu

Thông báo