Tài liệu API

API sử dụng JSON và HTTPS. Hộp thư hết hạn sau 24 giờ. Giữ token bí mật; token chỉ được trả về một lần khi tạo.

Danh sách domain

GET /api/domains
curl https://mail.fsave.store/api/domains

Tạo hộp thư

POST /api/mailboxes
Content-Type: application/json

curl -X POST https://mail.fsave.store/api/mailboxes \
 -H 'Content-Type: application/json' \
 -d '{"domain":"mail.fsave.store"}'

Phản hồi 201 gồm address, token và expires_at (Unix timestamp, giây).

Đọc thư

GET /api/messages
Authorization: Bearer TOKEN

curl https://mail.fsave.store/api/messages \
 -H 'Authorization: Bearer TOKEN'

Trả về address và danh sách messages gồm id, from, subject, body, received_at. Chỉ đọc phần văn bản thuần, không hỗ trợ tệp đính kèm. Token sai hoặc hết hạn trả về 401.