Developer
Xây dựng trên REST API của Mailera.
Nhập hộp thư Microsoft, đọc và gửi thư, kéo thư khỏi Spam và nhận webhook có chữ ký.
curl https://mailera.app/api/public/v1/mailboxes \ -H "X-API-Key: mh_live_..."Bắt đầu nhanh
- 1
Tạo API key
Đăng ký miễn phí, vào Cài đặt → API key và chọn quyền cho key.
- 2
Nhập hộp thư
Gửi danh sách hộp thư lên endpoint nhập và theo dõi kết quả từng dòng.
- 3
Đọc và gửi
Lấy thư theo thư mục, đọc mã OTP, gửi hoặc trả lời thư.
Nhóm endpoint
Hộp thư
Nhập, kiểm tra còn hoạt động, đồng bộ, tạm dừng và xoá hộp thư.
Xem endpointThư
Liệt kê, đọc, tìm kiếm, lấy OTP, gửi, trả lời và chuyển tiếp.
Xem endpointSpam
Kiểm tra thư vào Inbox hay Spam, kéo thư khỏi Spam.
Xem endpointWebhook
Đăng ký sự kiện thư mới, thư vào Spam và hộp thư mất kết nối.
Xem endpoint
Quyền của API key
Mỗi key chỉ làm được việc bạn cho phép.
| Quyền | Cho phép |
|---|---|
read | Đọc hộp thư, thư, OTP và vị trí Inbox/Spam |
move | Kéo khỏi Spam và di chuyển thư |
import | Thêm hộp thư |
sync | Yêu cầu đồng bộ ngay |
send | Gửi, trả lời và chuyển tiếp thư |
manage | Tạm dừng, bật lại và xoá hộp thư |
webhooks | Quản lý webhook |
Webhook
Nhận sự kiện ngay khi có thư.
Mailera gửi POST tới URL của bạn, ký HMAC-SHA256 trong header X‑MailHub‑Signature và tự gửi lại khi endpoint của bạn lỗi.
message.receivedCó thư mới vào Inboxmessage.junkCó thư mới rơi vào Spammailbox.disconnectedHộp thư mất kết nối (token bị thu hồi, đổi mật khẩu…)
Giới hạn và chi tiết
- Giới hạn gọi
- 300 lượt/phút cho mỗi key
- Xác thực
- Header X-API-Key
- Hộp thư mỗi workspace miễn phí
- Tối đa 1.000 hộp thư
- Phân trang
- cursor và next_cursor
- Mô tả máy đọc được
- OpenAPI 3.1 · llms.txt