Mailtr Developer API: tự động nhận OTP cho QA và AI agent
Mailtr Developer API cho phép bạn dùng code để tạo hộp thư dùng-một-lần (chỉ nhận), nhận email, và lấy mã OTP đã được tự trích sẵn — thay vì mở web đọc thư bằng tay. Đây là nền tảng cho kiểm thử tự động (QA/CI), automation và AI agent.
Khi nào nên dùng?
Kiểm thử tự động luồng đăng ký/đăng nhập cần nhận OTP hoặc link xác minh.
Kiểm thử chính sản phẩm của bạn: gửi email xác minh / đặt lại mật khẩu rồi assert nội dung.
AI agent tự đăng ký dịch vụ và tự vượt bước OTP qua MCP.
Tích hợp webhook: đẩy OTP/thư vào hệ thống nội bộ ngay khi thư tới.
Xác thực và base URL
Tạo API key trong Tài khoản → API (gói Free: 200 email/tháng, 60 request/phút). Mọi request gắn header X-API-Key. Base URL là https://mailtr.vn.
Các endpoint chính
Năm endpoint cốt lõi: tạo inbox, poll danh sách thư, đọc 1 thư (kèm OTP), xoá inbox, đăng ký webhook.
POST /api/v1/inbox # tạo inbox -> { id, address }
GET /api/v1/inbox/:id/messages # danh sách thư
GET /api/v1/messages/:id # 1 thư + otp tự trích
DELETE /api/v1/inbox/:id # xoá inbox
POST /api/v1/webhooks # đăng ký webhook -> { secret }Thử nhanh bằng curl
Tạo inbox, rồi đọc thư kèm OTP đã trích sẵn:
# Tạo inbox
curl -s https://mailtr.vn/api/v1/inbox -X POST \
-H "X-API-Key: $MAILTR_KEY" -H "content-type: application/json" -d "{}"
# Đọc 1 thư + OTP
curl -s https://mailtr.vn/api/v1/messages/$MSG_ID -H "X-API-Key: $MAILTR_KEY"
# -> { "message": { "otp": "246810", "text": "..." } }Tiếp theo
Xem các bài hướng dẫn tích hợp cụ thể: lấy OTP tự động bằng Python, test đăng ký bằng Playwright, và nhận OTP realtime qua webhook trong n8n. Bảng giá và tài liệu đầy đủ ở trang Lập trình viên (/api-docs).