# Aetherix Mail (aetherix.io.vn) — Tài liệu đầy đủ cho LLM & AI Agents

## 1. Tổng quan
Aetherix Mail (https://aetherix.io.vn) cung cấp hộp thư tạm thời tức thì kèm mã khôi phục **Recovery Key (RK-...)** và **Link Chia Sẻ 1-Click (https://aetherix.io.vn/?inbox=ten@aetherix.io.vn)**, cùng hệ thống REST API hoàn chỉnh cho lập trình viên.

## 2. REST API Endpoints
- `POST /api/mailboxes` hoặc `POST /mailboxes`: Tạo hộp thư mới.
- `GET /mailboxes/:address`: Xem chi tiết hộp thư (Bearer Auth).
- `GET /mailboxes/:address/messages`: Danh sách thư trong hộp thư (Bearer Auth).
- `GET /messages/:id`: Đọc nội dung chi tiết Text/HTML/Headers của 1 thư (Bearer Auth).
- `POST /mailboxes/:address/extend`: Gia hạn TTL cho hộp thư.
- `DELETE /mailboxes/:address`: Xóa hộp thư và toàn bộ thư.
- `GET /api/inbox`, `GET /api/inbox/count`, `GET /api/inbox/messages/:id`: Truy cập bằng header `X-Recovery-Key`.
- `GET /api/public/inbox?address=...` & `GET /api/public/messages/:id?address=...`: Tra cứu công khai (có Rate-Limit chống scan).
- `GET /api/domains` & `GET /health`: Kiểm tra danh sách domain và trạng thái hệ thống.

## 3. Câu hỏi thường gặp (FAQ)
### Q: Aetherix Mail là gì?
A: Aetherix Mail (aetherix.io.vn) là dịch vụ tạo email tạm thời (disposable temp mail) thế hệ mới với giao diện Pastel Pro siêu mượt, chạy 100% trên nền tảng Cloudflare Workers và Cloudflare D1. Dịch vụ giúp bạn nhận email kích hoạt và mã xác nhận OTP tức thì mà không cần lộ địa chỉ email cá nhân thật.

### Q: Email tạm thời tại Aetherix Mail có miễn phí không?
A: Hoàn toàn miễn phí 100%. Khách vãng lai có thể tạo ngay tối đa 5 email mỗi ngày không cần đăng ký tài khoản. Thành viên đăng ký miễn phí được tạo không giới hạn số lượng email, lưu trữ hộp thư vĩnh viễn (100 năm) và cấp phát REST API Key riêng.

### Q: Recovery Key là gì và làm thế nào để khôi phục hộp thư?
A: Mỗi email khi tạo sẽ đi kèm một mã khôi phục duy nhất gọi là Recovery Key (ví dụ: RK-xxxx). Bạn chỉ cần lưu mã này (hoặc Link Chia Sẻ 1-Click) để mở lại toàn bộ hộp thư bất cứ lúc nào trên bất kỳ thiết bị nào.

### Q: Hộp thư tạm thời tồn tại được bao lâu?
A: Khách vãng lai có thể tùy chọn thời hạn sống từ 5 phút đến 24 giờ (và tự động gia hạn thêm 24 giờ nếu có email mới gửi tới). Đối với tài khoản thành viên đã đăng ký, toàn bộ hộp thư được lưu giữ vĩnh viễn.

### Q: Aetherix Mail có hỗ trợ REST API cho lập trình viên không?
A: Có. Aetherix Mail cung cấp REST API đầy đủ hỗ trợ xác thực qua Bearer Token, Basic Auth hoặc Query String (?token=tm_...), cho phép tự động hóa tạo mailbox, đọc thư và trích xuất OTP trong CI/CD, Playwright, Puppeteer hoặc bot.

### Q: Dữ liệu và thư nhận được có an toàn và chống dò quét không?
A: Rất an toàn. Hệ thống trang bị 3 lớp bảo mật chống dò quét hộp thư công khai: Giới hạn tần suất tra cứu theo IP (Rate-Limit), hậu tố ngẫu nhiên 4 ký tự chống đoán tên và cơ chế Zero-Metadata Leak ẩn thông tin hộp thư trống.