Email tạm thời dành cho tác nhân AI
API email tạm thời không cần đăng ký, cho phép tác nhân tự tìm hiểu và sử dụng. Tạo hộp thư, chờ mã xác minh, đọc thư, lấy nội dung nguồn chưa xử lý và xóa thư chỉ qua HTTPS.
# Tìm các tên miền hiện có:
curl -s https://api.reusable.email/v1/agent-tempmail/domains
# 1. Tạo hộp thư tạm thời riêng tư. Không cần đăng ký hay khóa API.
curl -s -X POST https://api.reusable.email/v1/agent-tempmail/inboxes \
-H 'Content-Type: application/json' \
-d '{"prefix":"agent"}'
# 2. Đợi email xác minh hoặc mã OTP.
curl -s -X POST https://api.reusable.email/v1/agent-tempmail/inboxes/{address}/wait \
-H 'Authorization: Inbox {token}' \
-H 'Content-Type: application/json' \
-d '{"codeOnly":true,"timeoutSeconds":60}'
# 3. Đọc toàn bộ thư.
curl -s https://api.reusable.email/v1/agent-tempmail/inboxes/{address}/messages/{id} \
-H 'Authorization: Inbox {token}'{
"inbox": {
"address": "agent-lx84a9-q3mz2@reusable.email",
"domain": "reusable.email",
"created": true,
"type": "private",
"isProtected": true,
"retentionDays": 180
},
"password": "save-this-generated-password-securely",
"token": "use-this-as-an-inbox-token",
"tokenExpiresAt": "2026-06-09T18:30:00.000Z",
"links": {
"web": "https://reusable.email/agent-lx84a9-q3mz2%40reusable.email",
"messages": "https://api.reusable.email/v1/agent-tempmail/inboxes/agent-lx84a9-q3mz2%40reusable.email/messages",
"wait": "https://api.reusable.email/v1/agent-tempmail/inboxes/agent-lx84a9-q3mz2%40reusable.email/wait"
}
}{
"status": "message",
"inbox": { "address": "agent-lx84a9-q3mz2@reusable.email" },
"message": {
"id": 1842,
"from": { "name": "Example", "address": "login@example.com" },
"subject": "Your verification code",
"intro": "Use code 123456 to continue.",
"verificationCode": "123456"
}
}Đặc tả cho tác nhân
Tệp kê khai khám phá có tại /v1/agent-tempmail và được phản chiếu từ llms.txt cho các công cụ trả lời.
| Phương thức | Đường dẫn | Công dụng |
|---|---|---|
| GET | /v1/agent-tempmail | Tệp kê khai khám phá dành cho tác nhân và trình thu thập dữ liệu |
| GET | /v1/agent-tempmail/domains | Liệt kê các tên miền thay thế có sẵn |
| POST | /v1/agent-tempmail/inboxes | Tạo hộp thư riêng tư được bảo vệ bằng mật khẩu |
| GET | /v1/agent-tempmail/inboxes/{address}/messages | Liệt kê thư đã nhận |
| POST | /v1/agent-tempmail/inboxes/{address}/wait | Chờ thư hoặc mã bằng long polling |
| GET | /v1/agent-tempmail/inboxes/{address}/messages/{id} | Đọc thư |
| GET | /v1/agent-tempmail/inboxes/{address}/messages/{id}/source | Lấy nội dung nguồn RFC 5322 chưa xử lý |
| DELETE | /v1/agent-tempmail/inboxes/{address}/messages/{id} | Xóa thư |
Quy trình xác minh
Dùng hộp thư của tác nhân để nhận email đăng ký, đăng nhập, đặt lại mật khẩu và xác nhận dùng thử.
Tự động hóa trình duyệt
Kết hợp với Playwright, Selenium hoặc tác nhân duyệt web cần một địa chỉ email thực sự có thể nhận thư.
CI và QA
Tạo các hộp thư riêng biệt cho mỗi lần chạy thử mà không cần tạo tài khoản hay chia sẻ thông tin xác thực.
Câu hỏi thường gặp
Mọi người đều có thể tạo hộp thư riêng tư miễn phí mà không cần đăng ký. Để chọn tên miền khác, hãy truyền một tên miền từ endpoint danh sách tên miền. Giao diện tác nhân chỉ nhận thư. Với nhu cầu lớn hơn hoặc cần gửi thư, hãy dùng các API thông thường gắn với tài khoản.
Tôi có thể dùng khóa truy cập (passkey) với hộp thư của tác nhân không?+
Có. Đăng nhập bằng mật khẩu được tạo và thêm khóa truy cập (passkey) trong phần Cài đặt hộp thư. Nút hình chìa khóa trên biểu mẫu hộp thư riêng tư và màn hình mở khóa hộp thư hỗ trợ đăng nhập bằng passkey. Inbox token nhận được hoạt động với mọi endpoint hộp thư của tác nhân. Passkey yêu cầu người dùng xác minh tương tác; hãy giữ mật khẩu cho các tác nhân chạy không có người giám sát và cấp lại token hết hạn bằng POST /v1/inbox/{address}/token với JSON {"password":"..."}.
Tôi có thể chọn một tên miền thay thế không?+
Có. GET /v1/agent-tempmail/domains liệt kê các tên miền hiện có. Truyền domain cùng prefix hoặc địa chỉ chỉ gồm phần trước dấu @, hoặc cung cấp địa chỉ đầy đủ. Không thể nhận các địa chỉ đã tồn tại hoặc đã được dành riêng.
Tác nhân AI có thể sử dụng dịch vụ này mà không cần đăng ký không?+
Có. Tác nhân có thể tạo hộp thư bằng một yêu cầu POST không cần xác thực. Phản hồi bao gồm mật khẩu được tạo và Inbox token. Tất cả hộp thư được tạo đều là riêng tư. Hãy lưu mật khẩu để đăng nhập hộp thư riêng tư theo cách thông thường sau khi token hết hạn.
Có cần MCP, SDK hoặc cài đặt gì không?+
Không. Có thể truy cập đầy đủ giao diện qua HTTPS và curl. Các tác nhân có thể tìm thấy giao diện qua llms.txt hoặc tệp kê khai JSON tại /v1/agent-tempmail.
Tác nhân có thể gửi email qua API này không?+
Không. Giao diện dành cho tác nhân không cần đăng ký chỉ hỗ trợ nhận, đọc, chờ, lấy nguồn và xóa thư. Giao diện công khai này chủ ý không hỗ trợ gửi email.
Mã xác minh được cung cấp như thế nào?+
Phản hồi danh sách thư, chờ và chi tiết ưu tiên header OTP-Token thử nghiệm hợp lệ; nếu không có, hệ thống sẽ tìm mã trong văn bản. Mã lấy từ header có trường verificationCodeOrigin: trước khi nhập mã, hãy đối chiếu chính xác scheme, host và port của origin này với đích dự kiến. Không bao giờ tự động truy cập giá trị do người gửi cung cấp. Giá trị này không chứng minh danh tính người gửi.
Hộp thư do tác nhân tạo được lưu giữ trong bao lâu?+
Hộp thư do tác nhân tạo có các chức năng hộp thư riêng tư thông thường và lưu thư trong 180 ngày.