Dành cho nhà phát triển

Xây dựng ứng dụng với TempMail API

Tạo hộp thư và đọc mã xác minh qua HTTP. Bắt đầu ngay mà không cần tài khoản, hoặc tạo API key để mở khóa các tính năng Pro.

Không cần đăng nhập · Không cần API key

Bắt đầu ngay, ẩn danh

Cùng một API đang vận hành ứng dụng web TempMail. Mỗi hộp thư nhận một địa chỉ ngẫu nhiên và tồn tại trong 24 giờ.

  1. 1POST /accounts tạo hộp thư với địa chỉ và mật khẩu ngẫu nhiên.
  2. 2POST /token đổi địa chỉ và mật khẩu lấy mailbox token tm_box_.
  3. 3GET /messages trả về thư đến kèm mã xác minh đã được trích xuất sẵn.
BASE=https://www.tempmail.ai/api/v1

# 1. Create a mailbox (random address + password)
curl -s -X POST "$BASE/accounts" \
  -H "Content-Type: application/json" -d '{}'
# {"id":"…","address":"k3x9m2q7…@tempmail.ai","password":"…","expires_at":"…"}

# 2. Exchange the credentials for a mailbox token
curl -s -X POST "$BASE/token" \
  -H "Content-Type: application/json" \
  -d '{"address":"ADDRESS","password":"PASSWORD"}'
# {"id":"…","token":"tm_box_…","token_type":"Bearer","expires_at":"…"}

# 3. Read messages – verification codes are already extracted
curl -s "$BASE/messages" -H "Authorization: Bearer TOKEN"
# {"items":[{"from":"[email protected]","subject":"Your verification code","verification_code":"482913",…}],"total":1,…}
Xem toàn bộ tài liệu tham khảo API
Pro

API key cho các tính năng Pro

API key tm_live_ thuộc về tài khoản TempMail của bạn. Khi tài khoản đang ở gói Pro, key này sẽ tự động mở khóa:

  • Địa chỉ tùy chỉnh: gửi POST /accounts kèm key của bạn và trường "address"
  • Hạn mức cao hơn: 20 yêu cầu/giây và 1000 hộp thư mới mỗi ngày
  • Tối đa 10 địa chỉ riêng tư không thời hạn
  • Lưu trữ thư trong 30 ngày và 100 MB dung lượng lưu trữ

Tài khoản miễn phí cũng có thể tạo key. Key hoạt động tương tự API ẩn danh cho đến khi bạn nâng cấp mà không cần thay đổi code.