⚡ 1. Đăng Ký Nhanh Bearer API Key (tm_...)
Tạo khóa API miễn phí ngay lập tức để tích hợp vào tool tự động hóa, hoặc đăng ký tài khoản thành viên để quản lý hộp thư vĩnh viễn.
🌐 2. Public API & Recovery Key (Không Cần Token)
Tên miền hỗ trợ hiện tại: aetherix.io.vn
POST
/api/public/create
Tạo hộp thư nhanh cho khách (kèm
recovery_key)
GET
/api/public/inbox/:address
Đọc danh sách thư công khai theo địa chỉ email
GET
/api/public/inbox/:address/messages/:msgId
Đọc chi tiết nội dung HTML / Text của 1 email
GET
/api/recover/:key
Khôi phục hộp thư & danh sách thư bằng
RK-...
GET
/api/recover/:key/messages/:msgId
Đọc chi tiết thư qua Recovery Key
🔑 3. Developer API (Yêu cầu Authorization: Bearer tm_...)
POST
/mailboxes
Tạo hộp thư mới (
{ localPart, domain, ttlMinutes })
GET
/mailboxes
Liệt kê danh sách hộp thư thuộc API Key
GET
/mailboxes/:id/messages
Lấy danh sách email trong hộp thư
GET
/mailboxes/:id/messages/:messageId
Đọc toàn bộ nội dung HTML, Text & Raw Headers
DELETE
/mailboxes/:id
Xóa hộp thư và toàn bộ email bên trong
👤 4. Member Dashboard API (Tài Khoản Vĩnh Viễn 100 Năm)
POST
/api/auth/register
Đăng ký tài khoản miễn phí + nhận Bearer API Key
POST
/api/auth/login
Đăng nhập nhận
user_token
POST
/api/user/mailboxes
Tạo hộp thư vĩnh viễn 100 năm không giới hạn số lượng
GET
/api/my/notifications?since=0
Polling siêu nhẹ kiểm tra thư mới toàn tài khoản
💻 5. Ví Dụ Tích Hợp Thực Tế
// Node.js / Playwright — Tạo hộp thư & chờ nhận mã OTP tự động
const API_KEY = 'tm_your_api_key';
const BASE = 'https://aetherix.io.vn';
// 1. Tạo hộp thư mới
const mb = await fetch(`${BASE}/mailboxes`, {
method: 'POST',
headers: { 'Authorization': `Bearer ${API_KEY}`, 'Content-Type': 'application/json' },
body: JSON.stringify({ domain: 'aetherix.io.vn', ttlMinutes: 60 })
}).then(r => r.json());
console.log('Sử dụng email:', mb.address);
// 2. Poll chờ thư đến
const list = await fetch(`${BASE}/mailboxes/${mb.id}/messages`, {
headers: { 'Authorization': `Bearer ${API_KEY}` }
}).then(r => r.json());