REST API v2.0 · BASE URL: https://aetherix.io.vn

01 / Chính Sách Cấp Phát Bearer API Key (tm_...)

Mỗi tài khoản thành viên đăng ký được cấp phát duy nhất 1 API Key (tm_...) với hạn mức tiêu chuẩn 100 requests / giờ (hỗ trợ Header X-RateLimit-Remaining). Nếu cần nâng hạn mức cao hơn cho hệ thống lớn, Admin có thể điều chỉnh trực tiếp cho từng tài khoản.

Đăng Ký Tài Khoản Mới (Nhận 1 Key · 100 req/giờ) Mở Workspace Quản Lý Key

02 / Public API & Recovery Key (Không Cần Token)

Tên miền hỗ trợ hiện tại: aetherix.io.vn, lamous.shop, sillicon.io.vn, bytek.click, mail.aetherix.io.vn, pro.aetherix.io.vn, vip.aetherix.io.vn, cloud.aetherix.io.vn, mail.lamous.shop, pro.lamous.shop, vip.lamous.shop, deals.lamous.shop, member.lamous.shop, rewards.lamous.shop, mail.sillicon.io.vn, pro.sillicon.io.vn, vip.sillicon.io.vn, dev.sillicon.io.vn, cloud.sillicon.io.vn, ai.sillicon.io.vn, mail.bytek.click, pro.bytek.click, vip.bytek.click, dev.bytek.click, cloud.bytek.click

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

03 / Developer API (Authorization: Bearer tm_... · 100 req/giờ)

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

04 / Member Workspace 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í + cấp 1 Bearer API Key (100 req/giờ)
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
GET /api/my/notifications?since=0 Polling O(1) kiểm tra thư mới toàn tài khoản

05 / Ví Dụ Tích Hợp Thực Tế

// Node.js / Playwright — Tạo hộp thư & chờ nhận mã OTP tự động (100 req/hr quota)
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());
🐾 Click để mở Inbox nhanh
📬 Có thư mới!
1