Check OTP
Tài liệu API
Tổng quan GETDanh sách mail GETChi tiết một mail GETOTP mới nhất Ví dụ nhanh

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ênKiểuBắt buộcMô tả
emailstringCóĐị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ênKiểuBắt buộcMô tả
emailstringCóĐịa chỉ mail.
uidstringCóID của mail, lấy từ trường uid ở danh sách. Chỉ đọc được mail thuộc đúng địa chỉ này.
subjectstringKhôngTiêu đề dùng khi nguồn không trả về tiêu đề.
fromstringKhôngNgườ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ênKiểuBắt buộcMô tả
emailstringCóĐị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ố.