Tmailor Open API

API Email tạm thời cho Kiểm thử và Tự động hóa

Tạo địa chỉ email tạm thời chỉ nhận thư trực tiếp từ mã nguồn và đọc thư đến dưới dạng JSON. Mỗi địa chỉ sẽ được lưu trong tài khoản Tmailor cho đến khi bạn xóa, đồng thời API sẽ tự động trích xuất và trả về mã xác thực dùng một lần có trong thư.

Cập nhật lần cuối: October 2026

Bắt đầu miễn phí Xem tài liệu API

Xem các gói và giới hạn

REST và JSON
SDK, CLI và MCP server
100 hộp thư miễn phí mỗi tháng
Chỉ nhận, lưu thư 24 giờ

export TMAILOR_API_KEY="tmk_live_..."

# returns 201 with email, token, web.reuse_url
curl -s -X POST https://open-api.tmailor.com/v1/mailboxes \
  -H "Authorization: Bearer $TMAILOR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

# pip install tmailor-sdk
from tmailor import Client

with Client() as client:  # reads TMAILOR_API_KEY
    box = client.mailboxes.create()
    print(box.email)

    # trigger the email, then wait for it
    msg = box.wait_for_message(
        timeout=120, since=(box.created_at or 0) - 1)
    print(msg.subject, msg.otp(), msg.links())

// npm install tmailor
import { Client } from "tmailor";

const client = new Client(); // reads TMAILOR_API_KEY
const box = await client.mailboxes.create();
console.log(box.email);

// trigger the email, then wait for it
const msg = await box.waitForMessage({
  timeout: 120_000, since: box.createdAt - 1 });
console.log(msg.subject, msg.otp, msg.links);

<?php // composer require tmailor/tmailor
use Tmailor\Client;

$client = new Client(); // reads TMAILOR_API_KEY
$box = $client->mailboxes->create();
echo $box->email, "\n";

// trigger the email, then wait for it
$msg = $box->waitForMessage(
    timeout: 120, since: $box->createdAt - 1);
echo $msg->subject, ' ', $msg->otp;

Tạo địa chỉ, chờ email, đọc mã.

Thanh toán theo hộp thư, không tính theo yêu cầu

Chỉ thao tác tạo địa chỉ mới tính vào hạn ngạch hộp thư của bạn. Liệt kê địa chỉ, kiểm tra hộp thư đến, đọc hoặc xóa thư thì không. Các gói trả phí không giới hạn số lượng yêu cầu theo ngày hay tháng, chỉ có giới hạn tần suất theo phút.

Ví dụ: một bài kiểm tra OTP tạo một địa chỉ và kiểm tra hộp thư đến 25 lần chỉ tính là một hộp thư.

Từ khóa API đến hộp thư đến chỉ trong bốn bước

Tạo khóa API
Đăng nhập vào nền tảng API bằng tài khoản tmailor.com hoặc Google rồi tạo khóa. Với gói Miễn phí, hãy thêm cả địa chỉ IP duy nhất của máy chủ sẽ gọi API.
Tạo địa chỉ
Gửi một yêu cầu để nhận địa chỉ ngẫu nhiên trên tên miền dùng chung, hoặc chọn tên tùy chỉnh trên tên miền của riêng bạn đã được xác minh.
Đọc thư
Lấy danh sách hộp thư đến và đọc từng thư dưới dạng JSON: người gửi, tiêu đề, văn bản thuần, HTML đã làm sạch, cùng mã dùng một lần và các liên kết do API trích xuất.
Giữ lại hoặc xóa đi
Địa chỉ không hết hạn. Mở cùng hộp thư đến đó trên tmailor.com bằng liên kết tái sử dụng, hoặc xóa địa chỉ khi bạn thử nghiệm xong.

Tối ưu cho các luồng email lặp lại

Cấp cho mỗi lần chạy kiểm thử một hộp thư riêng thay vì dùng chung một hộp thư thật.

Kiểm thử đăng ký và OTP

Tạo địa chỉ mới cho mỗi lần đăng ký, đặt lại mật khẩu hoặc kiểm tra mã dùng một lần, sau đó đọc mã từ phản hồi.

Pipeline CI/CD

Chạy kiểm thử email đầu cuối (end-to-end) trong pipeline của bạn với khóa lưu trong biến môi trường. Các gói trả phí chấp nhận yêu cầu từ bất kỳ địa chỉ IP nào.

QA và môi trường staging

Cung cấp địa chỉ riêng cho kiểm thử viên và môi trường staging, giúp tách biệt hộp thư thật khỏi dữ liệu kiểm thử.

Địa chỉ trên tên miền riêng của bạn

Thêm một tên miền bạn sở hữu, trỏ bản ghi MX về hệ thống của chúng tôi và tạo địa chỉ với tên tùy chỉnh theo đúng quy tắc đặt tên.

Các gói và bảng giá

Chọn số lượng hộp thư bạn cần. Hạn mức của bạn được làm mới sau mỗi 30 ngày, kể cả với các gói hàng năm.

Miễn phí

Dùng thử API và chạy các dự án nhỏ.

$0 /tháng

100 hộp thư mỗi 30 ngày
Tối đa 30 yêu cầu mỗi phút
2,000 yêu cầu mỗi ngày
Gọi API từ một địa chỉ IP được cho phép
Tên miền dùng chung và tên miền riêng của bạn

Bắt đầu miễn phí

Starter

Dành cho một lập trình viên hoặc bộ kiểm thử nhỏ.

$9 /tháng

3,000 hộp thư mỗi 30 ngày
Tối đa 300 yêu cầu mỗi phút
Không giới hạn số yêu cầu mỗi ngày hay mỗi tháng
Gọi API từ bất kỳ địa chỉ IP nào
Tên miền dùng chung và tên miền riêng của bạn

Chọn Starter

Pro

Dành cho các nhóm chạy kiểm thử hằng ngày.

$29 /tháng

30,000 hộp thư mỗi 30 ngày
Tối đa 600 yêu cầu mỗi phút
Không giới hạn số yêu cầu mỗi ngày hay mỗi tháng
Gọi API từ bất kỳ địa chỉ IP nào
Tên miền dùng chung và tên miền riêng của bạn

Chọn Pro

Business

Dành cho các công ty có nhu cầu tự động hóa cao mỗi ngày.

$99 /tháng

150,000 hộp thư mỗi 30 ngày
Tối đa 2,000 yêu cầu mỗi phút
Không giới hạn số yêu cầu mỗi ngày hay mỗi tháng
Gọi API từ bất kỳ địa chỉ IP nào
Tên miền dùng chung và tên miền riêng của bạn

Chọn Business

Scale

Dành cho hệ thống kiểm thử lớn và pipeline hoạt động liên tục.

$199 /tháng

400,000 hộp thư mỗi 30 ngày
Tối đa 4,000 yêu cầu mỗi phút
Không giới hạn số yêu cầu mỗi ngày hay mỗi tháng
Gọi API từ bất kỳ địa chỉ IP nào
Tên miền dùng chung và tên miền riêng của bạn

Chọn Scale

Enterprise

Dành cho nhu cầu số lượng hộp thư và tốc độ yêu cầu cao nhất.

$499 /tháng

2,000,000 hộp thư mỗi 30 ngày
Tối đa 6,000 yêu cầu mỗi phút
Không giới hạn số yêu cầu mỗi ngày hay mỗi tháng
Gọi API từ bất kỳ địa chỉ IP nào
Tên miền dùng chung và tên miền riêng của bạn

Chọn Enterprise

So sánh các gói

Các giới hạn này thay đổi tùy theo từng gói. Mọi tính năng khác đều giống nhau ở mọi gói.

So sánh các gói
Gói	Miễn phí	Starter	Pro	Business	Scale	Enterprise
Giá theo tháng	$0	$9	$29	$99	$199	$499
Giá theo năm	$0	$90	$290	$990	$1,990	$4,990
Hộp thư mỗi 30 ngày	100	3,000	30,000	150,000	400,000	2,000,000
Yêu cầu mỗi phút	30	300	600	2,000	4,000	6,000
Giới hạn yêu cầu mỗi ngày	2,000	Không giới hạn	Không giới hạn	Không giới hạn	Không giới hạn	Không giới hạn
Danh sách IP cho phép	Bắt buộc, 1 IP	Không bắt buộc	Không bắt buộc	Không bắt buộc	Không bắt buộc	Không bắt buộc
Máy chủ MCP được lưu trữ	Chỉ máy chủ cục bộ	Bao gồm	Bao gồm	Bao gồm	Bao gồm	Bao gồm

Vuốt ngang để so sánh tất cả các gói.

Có trong mọi gói

REST API trả về kết quả JSON
Địa chỉ ngẫu nhiên trên các tên miền dùng chung
Tên tùy chỉnh trên tên miền riêng đã xác minh của bạn
Không giới hạn tên miền riêng (tối đa 3 tên miền chờ xác minh cùng lúc)
Địa chỉ không bao giờ hết hạn
Không giới hạn số lượng địa chỉ bạn lưu giữ
Thư được lưu trữ trong 24 giờ
Trích xuất mã dùng một lần và liên kết (theo khả năng tốt nhất)
Liên kết khôi phục để mở hộp thư đến trên tmailor.com
Các bộ SDK chính thức và công cụ dòng lệnh
Có thể gộp nhiều gói để cộng dồn hạn mức
Chỉ nhận thư, không kèm tệp đính kèm
Xóa địa chỉ không hoàn lại hạn mức

Khi dùng hết hạn mức hộp thư, bạn không thể tạo địa chỉ mới cho đến chu kỳ tiếp theo hoặc khi nâng cấp. Các hộp thư hiện có vẫn tiếp tục hoạt động.
Các khoản thanh toán không được hoàn lại theo điều khoản API. Hãy thử nghiệm tích hợp trên gói Miễn phí trước.

SDK và CLI chính thức

Gọi API từ ngôn ngữ lập trình của bạn với mô hình dữ liệu định kiểu, cơ chế tự động thử lại và hàm hỗ trợ chờ thư tiếp theo. Mọi SDK đều tuân theo cùng một API và chung bộ kịch bản kiểm thử.

Python

Có sẵn

Python 3.9+

pip install tmailor-sdk

Bao gồm tmailor.

Xem trên PyPI Mã nguồn trên GitHub

Node.js

Có sẵn

Node.js 18+, TypeScript types

npm install tmailor

Xem trên npm Mã nguồn trên GitHub

PHP

Có sẵn

PHP 8.1+

composer require tmailor/tmailor

Xem trên Packagist Mã nguồn trên GitHub

Dành cho tác nhân AI

Máy chủ MCP cho tác nhân AI

Cho phép Claude, Cursor, VS Code Copilot và các ứng dụng khách MCP khác kiểm thử luồng đăng ký mà bạn sở hữu hoặc được phép kiểm thử: tác nhân sẽ tạo một địa chỉ thật chỉ dùng để nhận thư, chờ email đến và đọc mã dùng một lần hoặc liên kết xác minh.

Cả hai lựa chọn đều cung cấp cho agent các công cụ giống nhau: tạo địa chỉ, chờ email và lấy mã dùng một lần cùng các liên kết, đọc tin nhắn, xóa địa chỉ và kiểm tra hạn mức của bạn. Agent chỉ thấy địa chỉ email, không bao giờ thấy token phía sau chúng, và sử dụng cùng hạn mức hộp thư và giới hạn tốc độ như API.

Máy chủ lưu trữ

Không cần cài đặt

https://mcp.tmailor.com/mcp

Thêm URL máy chủ vào ứng dụng AI của bạn. Các ứng dụng hỗ trợ đăng nhập như Claude, ChatGPT và Codex sẽ đưa bạn tới nền tảng Tmailor để cho phép truy cập. Các ứng dụng khác gửi khóa API của bạn trong header Authorization.

Cần gói trả phí đang hoạt động. Yêu cầu được gửi từ máy chủ của chúng tôi, nên bạn không cần danh sách IP được phép.

# Claude: add a custom connector with this URL,
# then approve access on the Tmailor platform
https://mcp.tmailor.com/mcp

# Claude Code, with your API key
claude mcp add --transport http tmailor \
  https://mcp.tmailor.com/mcp \
  --header "Authorization: Bearer tmk_live_..."

# Codex CLI, with your API key
export TMAILOR_API_KEY=tmk_live_...
codex mcp add tmailor \
  --url https://mcp.tmailor.com/mcp \
  --bearer-token-env-var TMAILOR_API_KEY

# Cursor (~/.cursor/mcp.json)
{"mcpServers": {"tmailor": {
  "url": "https://mcp.tmailor.com/mcp",
  "headers": {"Authorization": "Bearer tmk_live_..."}}}}

Xem các ứng dụng đã kết nối trên trang kết nối AI và ngắt kết nối bất kỳ ứng dụng nào. Ứng dụng đã ngắt kết nối sẽ mất quyền truy cập trong vòng 30 giây.

Xem các gói và giới hạn

Máy chủ cục bộ

Mọi gói, kể cả Miễn phí

tmailor-mcp

Máy chủ này chạy trên máy tính của bạn, đọc khóa từ TMAILOR_API_KEY và yêu cầu có uv hoặc Python 3.10+. Với gói Miễn phí, hãy thêm địa chỉ IP của máy tính đó vào danh sách cho phép.

# Claude Code
claude mcp add tmailor \
  -e TMAILOR_API_KEY=tmk_live_... \
  -- uvx tmailor-mcp

# Claude Desktop, Cursor, VS Code
#   command: uvx   args: ["tmailor-mcp"]

# without uv
pip install tmailor-mcp

Xem trên PyPI Hướng dẫn thiết lập cho từng ứng dụng khách MCP

Hãy thử hỏi: "Tạo một email tạm thời, đăng ký trên trang staging của tôi bằng email đó và cho tôi biết mã xác minh."

Câu hỏi thường gặp về API email tạm thời

Thao tác nào được tính là một hộp thư?

Mỗi địa chỉ mới bạn tạo sẽ dùng một hộp thư trong hạn mức của chu kỳ 30 ngày hiện tại. Việc liệt kê, đọc và xóa không làm tốn hộp thư, đồng thời xóa một địa chỉ cũng không hoàn lại hộp thư đó.

Địa chỉ có hết hạn không?

Không. Địa chỉ sẽ nằm trong tài khoản của bạn cho đến khi bạn xóa đi. Thư trong đó được lưu giữ trong 24 giờ.

Tôi có thể gửi email hoặc nhận tệp đính kèm không?

Không. API chỉ hỗ trợ nhận thư và không chuyển các tệp đính kèm.

Tôi có thể tự chọn tên địa chỉ và tên miền không?

Trên các tên miền dùng chung của chúng tôi, phần tên được tạo ngẫu nhiên. Để tự chọn tên, hãy thêm và xác minh tên miền của riêng bạn trên nền tảng API bằng cách trỏ bản ghi MX về chúng tôi, sau đó tạo địa chỉ với tên tùy chỉnh theo quy tắc đặt tên.

Tôi có cần thiết lập danh sách IP cho phép (IP allowlist) không?

Chỉ bắt buộc với gói Miễn phí, trong đó bạn thêm một địa chỉ IP duy nhất mà máy chủ của bạn dùng để gọi API. Mỗi địa chỉ IP chỉ gắn được với một tài khoản Miễn phí, nên IP dùng chung của văn phòng hoặc VPN có thể đã có người dùng. Khi có gói trả phí đang hoạt động, API chấp nhận yêu cầu từ mọi địa chỉ IP.

API có tự trích xuất mã xác minh giúp tôi không?

Có, ở mức hỗ trợ tối đa nhưng không đảm bảo tuyệt đối. Khi bạn đọc thư, phản hồi trả về sẽ kèm theo mã dùng một lần tìm được (hoặc null nếu không chắc chắn), các giá trị giống mã khác và các đường liên kết. Hãy luôn kiểm tra lại giá trị này trong bài kiểm thử của bạn.

Các tác nhân AI như Claude hoặc ChatGPT có dùng được API không?

Có, thông qua MCP. Trên gói trả phí, hãy thêm máy chủ lưu trữ https://mcp.tmailor.com/mcp vào ứng dụng AI của bạn và phê duyệt quyền truy cập, hoặc gửi khóa API của bạn. Trên bất kỳ gói nào, bạn đều có thể chạy máy chủ mã nguồn mở tmailor-mcp trên máy tính của mình. Dù theo cách nào, tác nhân đều có thể tạo địa chỉ, chờ email và đọc mã dùng một lần, sử dụng cùng hạn mức hộp thư như API.

Gói trả phí có giới hạn số lượng yêu cầu không?

Các gói trả phí không giới hạn hạn mức yêu cầu theo ngày hay tháng, nhưng mỗi gói có giới hạn tần suất gọi mỗi phút. Gói Miễn phí có thêm giới hạn số yêu cầu mỗi ngày.

Tôi có cần thẻ tín dụng để bắt đầu không?

Không. Đăng nhập bằng tài khoản tmailor.com hoặc Google, tạo khóa API và bắt đầu với gói Miễn phí. Bạn chỉ thanh toán khi chọn nâng cấp lên gói trả phí.

Tôi có thể thanh toán gói bằng cách nào?

Thanh toán bằng USDT trên mạng TRC20 (Tron) hoặc BEP20 (BNB Smart Chain), hoặc qua Binance Pay. Không nhận thẻ tín dụng và thẻ ghi nợ. Gói được kích hoạt khi thanh toán được xác nhận, thường chỉ trong vài phút.

Tôi có được hoàn tiền không?

Không. Các khoản thanh toán không được hoàn lại, vì vậy hãy thử nghiệm tích hợp trên gói Miễn phí trước khi nâng cấp.

Những hành vi nào bị cấm khi sử dụng API?

Các hành vi phát tán thư rác (spam), gian lận, tạo tài khoản hàng loạt trên các dịch vụ khác cũng như lách lệnh cấm hoặc giới hạn của họ đều vi phạm điều khoản sử dụng API. Chúng tôi có thể thu hồi khóa API và khóa các tài khoản thực hiện hành vi này.

Tạo địa chỉ đầu tiên chỉ trong vài phút

Bắt đầu bằng gói Miễn phí với 100 hộp thư mỗi tháng. Không cần thẻ tín dụng.

Bắt đầu miễn phí Xem tài liệu API

API Email tạm thời cho Kiểm thử và Tự động hóa

Thanh toán theo hộp thư, không tính theo yêu cầu

Từ khóa API đến hộp thư đến chỉ trong bốn bước

Tạo khóa API

Tạo địa chỉ

Đọc thư

Giữ lại hoặc xóa đi

Tối ưu cho các luồng email lặp lại

Kiểm thử đăng ký và OTP

Pipeline CI/CD

QA và môi trường staging

Địa chỉ trên tên miền riêng của bạn

Các gói và bảng giá

Miễn phí

Starter

Pro

Business

Scale

Enterprise

So sánh các gói

Có trong mọi gói

SDK và CLI chính thức

Python

Node.js

PHP

Máy chủ MCP cho tác nhân AI

Máy chủ lưu trữ

Máy chủ cục bộ

Câu hỏi thường gặp về API email tạm thời

Tạo địa chỉ đầu tiên chỉ trong vài phút