Tmailor Open API

API временной почты для тестирования и автоматизации

Создавайте из кода временные адреса электронной почты, работающие только на приём, и читайте входящие сообщения в формате JSON. Каждый адрес остаётся в вашем аккаунте Tmailor, пока вы его не удалите, а API возвращает одноразовый код, найденный в сообщении.

Последнее обновление: October 2026

Начать бесплатно Читать документацию API

Планы и лимиты

REST и JSON
SDK, CLI и MCP-сервер
100 бесплатных почтовых ящиков в месяц
Только приём, сообщения хранятся 24 часа

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;

Создайте адрес, дождитесь письма, прочитайте код.

Платите за почтовый ящик, а не за запрос

Квота почтовых ящиков расходуется только при создании адреса. Просмотр списка адресов, проверка входящих, чтение и удаление сообщений её не расходуют. На платных планах нет дневной или месячной квоты на запросы — только ограничение по числу запросов в минуту.

Пример: тест OTP, который создаёт один адрес и 25 раз проверяет входящие, расходует один почтовый ящик.

От ключа API до входящих за четыре шага

Создайте ключ API
Войдите на платформу API через свой аккаунт tmailor.com или Google и создайте ключ. На бесплатном плане также добавьте один IP-адрес сервера, с которого будут вызывать API.
Создайте адрес
Отправьте один запрос, чтобы получить случайный адрес на общем домене, или выберите собственное имя на домене, которым владеете и который подтвердили.
Читайте сообщения
Получите список входящих и читайте каждое сообщение в формате JSON: отправитель, тема, текст, очищенный HTML, а также одноразовый код и ссылки, найденные API.
Сохраните или удалите
Срок действия адресов не истекает. Откройте тот же почтовый ящик на tmailor.com по ссылке для повторного использования или удалите адрес, когда закончите тест.

Создано для повторяемых сценариев работы с почтой

Выделите каждому тестовому запуску отдельный ящик вместо одного общего настоящего почтового ящика.

Тесты регистрации и OTP

Создавайте новый адрес для каждой регистрации, сброса пароля или проверки одноразового кода, а затем читайте код из ответа.

Конвейеры CI/CD

Запускайте сквозные проверки почты в конвейере, передавая ключ через переменную среды. Платные планы принимают запросы с любого IP-адреса.

QA и staging

Выделите тестировщикам и средам staging собственные адреса и не допускайте попадания настоящих почтовых ящиков в тестовые данные.

Адреса на вашем домене

Добавьте домен, который вам принадлежит, направьте его MX-запись на нас и создавайте адреса с пользовательскими именами, соответствующими правилам именования.

Планы и цены

Выберите нужное количество почтовых ящиков. Лимит обновляется каждые 30 дней, в том числе на годовых планах.

Бесплатный

Попробуйте API и запускайте небольшие проекты.

$0 /месяц

100 почтовых ящиков каждые 30 дней
До 30 запросов в минуту
2,000 запросов в день
Запросы с одного IP-адреса из списка разрешённых
Общие домены и ваши собственные домены

Начать бесплатно

Starter

Для одного разработчика или небольшого набора тестов.

$9 /месяц

3,000 почтовых ящиков каждые 30 дней
До 300 запросов в минуту
Без дневной или месячной квоты на запросы
Запросы с любого IP-адреса
Общие домены и ваши собственные домены

Выбрать Starter

Pro

Для команд, которые запускают тесты каждый день.

$29 /месяц

30,000 почтовых ящиков каждые 30 дней
До 600 запросов в минуту
Без дневной или месячной квоты на запросы
Запросы с любого IP-адреса
Общие домены и ваши собственные домены

Выбрать Pro

Бизнес

Для компаний с интенсивной ежедневной автоматизацией.

$99 /месяц

150,000 почтовых ящиков каждые 30 дней
До 2,000 запросов в минуту
Без дневной или месячной квоты на запросы
Запросы с любого IP-адреса
Общие домены и ваши собственные домены

Выбрать Бизнес

Scale

Для больших парков тестов и загруженных пайплайнов.

$199 /месяц

400,000 почтовых ящиков каждые 30 дней
До 4,000 запросов в минуту
Без дневной или месячной квоты на запросы
Запросы с любого IP-адреса
Общие домены и ваши собственные домены

Выбрать Scale

Enterprise

Для максимального объёма почтовых ящиков и частоты запросов.

$499 /месяц

2,000,000 почтовых ящиков каждые 30 дней
До 6,000 запросов в минуту
Без дневной или месячной квоты на запросы
Запросы с любого IP-адреса
Общие домены и ваши собственные домены

Выбрать Enterprise

Сравнение планов

Эти ограничения отличаются в зависимости от плана. Всё остальное одинаково на всех планах.

Сравнение планов
План	Бесплатный	Starter	Pro	Бизнес	Scale	Enterprise
Цена при месячной оплате	$0	$9	$29	$99	$199	$499
Цена при годовой оплате	$0	$90	$290	$990	$1,990	$4,990
Почтовые ящики каждые 30 дней	100	3,000	30,000	150,000	400,000	2,000,000
Запросов в минуту	30	300	600	2,000	4,000	6,000
Дневной лимит запросов	2,000	Без ограничений	Без ограничений	Без ограничений	Без ограничений	Без ограничений
Список разрешённых IP	Обязательно, 1 IP	Не требуется	Не требуется	Не требуется	Не требуется	Не требуется
Размещённый MCP-сервер	Только локальный сервер	Включено	Включено	Включено	Включено	Включено

Проведите вбок, чтобы сравнить все планы.

Включено во все планы

REST API с ответами в JSON
Случайные адреса на общих доменах
Собственные имена на ваших проверенных доменах
Неограниченное количество собственных доменов (до 3 могут одновременно ожидать подтверждения)
Адреса без срока действия
Без ограничений на количество хранимых адресов
Сообщения хранятся 24 часа
Извлечение одноразовых кодов и ссылок (по возможности)
Ссылка для открытия ящика на tmailor.com
Официальные SDK и инструмент командной строки
Планы можно комбинировать, их лимиты суммируются
Только приём, без вложений
Удаление адреса не возвращает квоту

Когда лимит почтовых ящиков исчерпан, новые адреса нельзя создавать до следующего цикла или до перехода на другой тариф. Существующие ящики продолжают работать.
Платежи не возвращаются согласно API. Сначала протестируйте интеграцию на бесплатном тарифе.

Официальные SDK и CLI

Вызывайте API из своего языка с типизированными моделями, автоматическими повторами запросов и помощником, который ждёт следующего сообщения. Все SDK используют один и тот же API и общие тестовые сценарии.

Python

Доступно

Python 3.9+

pip install tmailor-sdk

Включает tmailor.

Открыть на PyPI Исходный код на GitHub

Node.js

Доступно

Node.js 18+, TypeScript types

npm install tmailor

Открыть на npm Исходный код на GitHub

PHP

Доступно

PHP 8.1+

composer require tmailor/tmailor

Открыть на Packagist Исходный код на GitHub

Для ИИ-агентов

MCP-сервер для ИИ-агентов

Позвольте Claude, Cursor, VS Code Copilot и другим MCP-клиентам тестировать сценарии регистрации, которые вам принадлежат или которые вам разрешено тестировать: агент создаёт реальный адрес только для получения писем, ждёт письмо и читает одноразовый код или ссылку для подтверждения.

Оба варианта дают агенту одинаковые инструменты: создать адрес, дождаться письма и получить его одноразовый код и ссылки, читать сообщения, удалять адреса и проверять квоту. Агент видит только адреса электронной почты, но никогда не токены за ними, и использует ту же квоту почтового ящика и ограничение частоты запросов, что и API.

Сервер в облаке

Ничего устанавливать не нужно

https://mcp.tmailor.com/mcp

Добавьте URL сервера в своё AI-приложение. Приложения с поддержкой входа, такие как Claude, ChatGPT и Codex, перенаправляют вас на платформу Tmailor для одобрения доступа. Другие клиенты передают ваш API-ключ в заголовке Authorization.

Требуется активный платный план. Запросы идут с нашего сервера, поэтому добавлять IP в список разрешённых не нужно.

# 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_..."}}}}

Посмотрите подключённые приложения на странице AI connections и отключите любое из них. Отключённое приложение теряет доступ в течение 30 секунд.

Планы и лимиты

Локальный сервер

Все тарифы, включая бесплатный

tmailor-mcp

Он работает на вашем компьютере, берёт ключ из TMAILOR_API_KEY и требует uv или Python 3.10+. На бесплатном плане добавьте IP-адрес этого компьютера в список разрешённых.

# 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

Открыть на PyPI Настройка для каждого MCP-клиента

Попробуйте спросить: «Создай временную почту, зарегистрируйся с ней на моём тестовом сайте и скажи код подтверждения».

Вопросы и ответы по API временной почты

Что считается почтовым ящиком?

Каждый новый адрес, который вы создаёте, занимает один почтовый ящик из лимита текущего 30-дневного цикла. Просмотр списка, чтение и удаление почтовые ящики не расходуют, а удаление адреса не возвращает ящик.

Истекает ли срок действия адресов?

Нет. Адрес остаётся в вашем аккаунте, пока вы его не удалите. Сообщения в нём хранятся 24 часа.

Могу ли я отправлять письма или получать вложения?

Нет. API работает только на приём, а вложения не доставляются.

Могу ли я выбрать имя адреса и домен?

На наших общих доменах имя случайное. Чтобы выбрать имя, добавьте на платформе API свой домен и подтвердите его, направив его MX-запись на нас, а затем создавайте адреса с собственным именем, соблюдая правила именования.

Нужен ли мне список разрешённых IP?

Только на бесплатном тарифе, где вы указываете единственный IP-адрес, с которого обращается ваш сервер. IP-адрес может быть привязан только к одному бесплатному аккаунту, поэтому общий адрес офиса или VPN может уже использоваться. При активном платном тарифе API принимает запросы с любого IP-адреса.

API сам читает код подтверждения за меня?

Да, по возможности. При чтении сообщения ответ содержит найденный одноразовый код (или null, если он не уверен), другие значения, похожие на код, и ссылки. Всегда проверяйте значение в своём тесте.

Могут ли ИИ-агенты, такие как Claude или ChatGPT, использовать API?

Да, через MCP. На платном тарифе добавьте размещённый сервер https://mcp.tmailor.com/mcp в своё ИИ-приложение и одобрите доступ либо передайте свой API-ключ. На любом тарифе вы можете запустить открытый сервер tmailor-mcp на своём компьютере. В обоих случаях агент может создать адрес, дождаться письма и прочитать одноразовый код, используя ту же квоту почтовых ящиков, что и API.

Есть ли на платных тарифах лимит запросов?

На платных тарифах нет суточной или месячной квоты на запросы, но у каждого тарифа есть лимит запросов в минуту. На бесплатном тарифе также есть суточный лимит запросов.

Нужна ли кредитная карта для начала работы?

Нет. Войдите со своим аккаунтом tmailor.com или через Google, создайте ключ и начните с бесплатного тарифа. Вы платите только при выборе платного тарифа.

Как оплатить тариф?

Оплата в USDT в сети TRC20 (Tron) или BEP20 (BNB Smart Chain) либо через Binance Pay. Кредитные и дебетовые карты не принимаются. Тариф активируется после подтверждения платежа, обычно в течение нескольких минут.

Могу ли я получить возврат средств?

Нет. Платежи не возвращаются, поэтому перед переходом на платный тариф протестируйте интеграцию на бесплатном.

Для чего нельзя использовать API?

Спам, мошенничество, массовое создание аккаунтов на других сервисах и обход их блокировок или ограничений нарушают условия API. Мы можем отозвать API-ключи таких аккаунтов и заблокировать их.

Создайте свой первый адрес за несколько минут

Начните с бесплатного тарифа: 100 почтовых ящиков в месяц. Кредитная карта не требуется.

Начать бесплатно Читать документацию API

API временной почты для тестирования и автоматизации

Платите за почтовый ящик, а не за запрос

От ключа API до входящих за четыре шага

Создайте ключ API

Создайте адрес

Читайте сообщения

Сохраните или удалите

Создано для повторяемых сценариев работы с почтой

Тесты регистрации и OTP

Конвейеры CI/CD

QA и staging

Адреса на вашем домене

Планы и цены

Бесплатный

Starter

Pro

Бизнес

Scale

Enterprise

Сравнение планов

Включено во все планы

Официальные SDK и CLI

Python

Node.js

PHP

MCP-сервер для ИИ-агентов

Сервер в облаке

Локальный сервер

Вопросы и ответы по API временной почты

Создайте свой первый адрес за несколько минут