Mail API
Đọc mail và mã OTP của một địa chỉ email qua HTTP. Hộp thư chưa có thì tự tạo khi gọi lần đầu.
Chỉ đọcMọi endpoint đều dùng GET, không xoá hay sửa thư.
Không cần xác thựcKhông có token hay header đặc biệt. Gọi được cả từ trình duyệt (CORS mở).
Truyền email qua queryDùng tham số
?email= cho mọi request.⚠ Lưu ý trước khi lấy OTP: gọi GET /api/v1/mail?email=… một lần trước khi yêu cầu dịch vụ gửi mã.
Lần gọi này tạo hộp thư, hoặc gia hạn thêm 7 ngày nếu hộp thư đã hết hạn. Thư gửi đến lúc hộp thư đã hết hạn sẽ không được nhận và không lấy lại được.
Lấy danh sách mail
Trả về các email một địa chỉ đã nhận (mới nhất trước), kèm mã OTP nếu trích được.
GET/api/v1/mail?email={email}
Tham số
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
| string | Có | Địa chỉ mail đầy đủ. |
Thử ngay
Ví dụ phản hồi
Lấy chi tiết một mail
Trả về nội dung HTML và văn bản đầy đủ của một mail. Lấy uid từ trường cùng tên trong danh sách mail.
GET/api/v1/mail/detail?email={email}&uid={uid}
Tham số
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
| string | Có | Địa chỉ mail. | |
| uid | string | Có | ID của mail, lấy từ trường uid ở danh sách. Chỉ đọc được mail thuộc đúng địa chỉ này. |
| subject | string | Không | Tiêu đề dùng khi nguồn không trả về tiêu đề. |
| from | string | Không | Người gửi dùng khi nguồn không trả về người gửi. |
Thử ngay
Ví dụ phản hồi
Lấy OTP mới nhất
Chỉ trả mã OTP mới nhất, dạng văn bản thuần (không phải JSON). Nếu chưa có OTP, server trả HTTP 404 với nội dung rỗng.
GET/api/v1/mail/otp?email={email}
Tham số
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
| string | Có | Địa chỉ mail. |
Thử ngay
Ví dụ phản hồi
Ví dụ nhanh
Lấy OTP mới nhất của một địa chỉ và chỉ nhận lại đúng dãy số.