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 та стейджинг

Надайте тестувальникам і стейджинг-середовищам власні адреси, щоб реальні поштові скриньки не потрапляли в тестові дані.

Адреси на вашому власному домені

Додайте домен, яким ви володієт, спрямуйте його 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

Business

Для компаній з інтенсивною щоденною автоматизацією.

$99 /місяць

150,000 поштових скриньок кожні 30 днів
До 2,000 запитів за хвилину
Без денної чи місячної квоти запитів
Запити з будь-якої IP-адреси
Спільні домени та власні домени

Обрати Business

Scale

Для великих тестових парків і завантажених пайплайнів.

$199 /місяць

400,000 поштових скриньок кожні 30 днів
До 4,000 запитів за хвилину
Без денної чи місячної квоти запитів
Запити з будь-якої IP-адреси
Спільні домени та власні домени

Обрати Scale

Enterprise

Для найбільшого обсягу поштових скриньок і найвищої частоти запитів.

$499 /місяць

2,000,000 поштових скриньок кожні 30 днів
До 6,000 запитів за хвилину
Без денної чи місячної квоти запитів
Запити з будь-якої IP-адреси
Спільні домени та власні домени

Обрати Enterprise

Порівняння планів

Ці обмеження відрізняються залежно від плану. Усе інше однакове на всіх планах.

Порівняння планів
План	Безкоштовний	Starter	Pro	Business	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

Спробуйте запитати: «Створи тимчасову електронну адресу, зареєструйся з нею на моєму staging-сайті та скажи мені код підтвердження.»

Часті запитання про API тимчасової пошти

Що вважається однією поштовою скринькою?

Кожна нова адреса, яку ви створюєте, використовує одну поштову скриньку з ліміту поточного 30-денного циклу. Перегляд списку, читання та видалення не витрачають поштові скриньки, а видалення адреси не повертає скриньку назад.

Чи спливає термін дії адрес?

Ні. Адреса залишається у вашому акаунті, доки ви її не видалите. Повідомлення в ній зберігаються 24 години.

Чи можу я надсилати листи або отримувати вкладення?

Ні. API працює лише на приймання, а вкладення не доставляються.

Чи можу я вибрати ім'я адреси та домен?

На наших спільних доменах ім'я випадкове. Щоб вибрати ім'я, додайте та підтвердьте власний домен на платформі API, спрямувавши його MX-запис на нас, а потім створюйте адреси з власним ім'ям, що відповідає правилам іменування.

Чи потрібен мені список дозволених IP?

Лише на безкоштовному тарифі, де ви додаєте одну IP-адресу, з якої звертається ваш сервер. IP-адреса може належати лише одному безкоштовному обліковому запису, тому спільна офісна адреса або адреса VPN може вже бути зайнятою. З активним платним тарифом API приймає запити з будь-якої IP-адреси.

Чи API зчитує код підтвердження за мене?

Так, за можливості. Коли ви читаєте повідомлення, відповідь містить знайдений одноразовий код (або null, якщо він не впевнений), інші схожі на код значення та посилання. Завжди перевіряйте значення у своєму тесті.

Чи можуть AI-агенти, як-от Claude або ChatGPT, використовувати API?

Так, через MCP. На платному тарифі додайте хостовий сервер https://mcp.tmailor.com/mcp до свого AI-додатка та надайте доступ або надішліть свій 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 та стейджинг

Адреси на вашому власному домені

Тарифи та ціни

Безкоштовний

Starter

Pro

Business

Scale

Enterprise

Порівняння планів

Включено в кожен план

Офіційні SDK та CLI

Python

Node.js

PHP

MCP-сервер для агентів ШІ

Розміщений сервер

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

Часті запитання про API тимчасової пошти

Створіть свою першу адресу за кілька хвилин