← Về trang chủ

Tài liệu API

API sử dụng JSON và HTTPS. Hộp thư hết hạn sau 24 giờ. Hộp thư công khai: ai biết địa chỉ đều có thể đọc thư. Token vẫn được trả về khi tạo hộp thư mới để giữ tương thích API cũ.

Danh sách domain

GET /api/domains
curl https://mail.lightingmedia.net/api/domains

Tạo hộp thư

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

curl -X POST https://mail.lightingmedia.net/api/mailboxes \
 -H 'Content-Type: application/json' \
 -d '{"domain":"lightingmedia.net","name":"ten-email"}'

Tên là tùy chọn; bỏ trống để tạo ngẫu nhiên. Hộp thư mới trả về 201 với address, token và expires_at. Nếu tên đang tồn tại, trả về 200 cùng address và existing=true.

Đọc thư

GET /api/messages
Authorization: Bearer TOKEN

curl https://mail.lightingmedia.net/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.

Đọc hộp thư công khai

GET /api/public/messages?address=ten-email%40lightingmedia.net

curl "https://mail.lightingmedia.net/api/public/messages?address=ten-email%40lightingmedia.net"

Không cần token. Trả về 404 nếu hộp thư không tồn tại hoặc đã hết hạn.

API tương thích hệ thống đọc mail domain

GET /messages?username=demo&domain=lightingmedia.net
curl -G https://mail.lightingmedia.net/messages --data-urlencode 'username=demo' --data-urlencode 'domain=lightingmedia.net'

Trả về result: mảng gồm id, from, subject, date (UTC) và message. Có thể nhận thư tới địa chỉ hợp lệ trên domain đã xác minh mà không cần tạo hộp thư trước.

POST /messages
Content-Type: application/x-www-form-urlencoded
curl -X POST https://mail.lightingmedia.net/messages -d 'id=123&username=demo&domain=lightingmedia.net'

Trả về message chứa nội dung văn bản thuần. Thư và hộp thư vẫn hết hạn sau 24 giờ và chịu giới hạn số thư cấu hình tại trang quản trị.