Tmailor Open API

Temp Mail API pro testování a automatizaci

Vytvářejte z kódu dočasné e-mailové adresy pouze pro příjem a čtěte příchozí zprávy jako JSON. Každá adresa zůstává ve vašem účtu Tmailor, dokud ji nesmažete, a API vrací jednorázový kód, který ve zprávě najde.

Poslední aktualizace: October 2026

Začněte zdarma Přečtěte si dokumentaci API

Zobrazit plány a limity

REST a JSON
SDK, CLI a MCP server
100 poštovních schránek zdarma měsíčně
Pouze příjem, zprávy na 24 hodin

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;

Vytvořte adresu, počkejte na e-mail, přečtěte kód.

Plaťte za schránku, ne za požadavek

Kvótu schránek spotřebovává pouze vytvoření adresy. Výpis adres, kontrola doručené pošty ani čtení či mazání zpráv se do ní nezapočítávají. Placené tarify nemají denní ani měsíční kvótu požadavků, pouze limit požadavků za minutu.

Příklad: OTP test, který vytvoří jednu adresu a 25krát zkontroluje doručenou poštu, spotřebuje jednu schránku.

Od API klíče ke schránce ve čtyřech krocích

Vytvořte API klíč
Přihlaste se do platformy API pomocí účtu tmailor.com nebo Google a vytvořte klíč. V rámci bezplatného plánu také přidejte jednu IP adresu serveru, která bude API volat.
Vytvořte adresu
Pošlete jeden požadavek a získáte náhodnou adresu na sdílené doméně, nebo si zvolte vlastní jméno na doméně, kterou vlastníte a máte ověřenou.
Přečtěte si zprávy
Vypište doručenou poštu a čtěte každou zprávu jako JSON: odesílatel, předmět, text, vyčištěné HTML a jednorázový kód a odkazy, které API našlo.
Nechte si ji, nebo ji smažte
Adresy nevyprší. Otevřete stejnou schránku na tmailor.com pomocí odkazu pro opětovné použití, nebo adresu po dokončení testu smažte.

Vytvořeno pro opakovatelné e-mailové postupy

Každému testovacímu běhu dejte vlastní schránku místo sdílení jedné skutečné schránky.

Registrace a OTP testy

Vytvořte novou adresu pro každou registraci, resetování hesla nebo kontrolu jednorázového kódu a poté přečtěte kód z odpovědi.

CI/CD pipeline

Spouštějte end-to-end kontroly e-mailů ve svém pipeline s klíčem v proměnné prostředí. Placené tarify přijímají požadavky z jakékoli IP adresy.

QA a staging

Dejte testerům a stagingovým prostředím vlastní adresy a udržujte skutečné schránky mimo testovací data.

Adresy na vaší vlastní doméně

Přidejte doménu, kterou vlastníte, nasměrujte na nás její MX záznam a vytvořte adresy s vlastními jmény, která odpovídají pravidlům pojmenování.

Tarify a ceny

Vyberte si počet schránek, které potřebujete. Váš limit se obnovuje každých 30 dní, a to i u ročních plánů.

Zdarma

Vyzkoušejte API a spouštějte malé projekty.

$0 /měsíc

100 poštovních schránek každých 30 dní
Až 30 požadavků za minutu
2,000 požadavků za den
Volání z jedné povolené IP adresy
Sdílené domény a vaše vlastní domény

Začněte zdarma

Starter

Pro vývojáře nebo malou testovací sadu.

$9 /měsíc

3,000 poštovních schránek každých 30 dní
Až 300 požadavků za minutu
Žádná denní ani měsíční kvóta požadavků
Volání z jakékoli IP adresy
Sdílené domény a vaše vlastní domény

Vybrat Starter

Pro

Pro týmy, které testují každý den.

$29 /měsíc

30,000 poštovních schránek každých 30 dní
Až 600 požadavků za minutu
Žádná denní ani měsíční kvóta požadavků
Volání z jakékoli IP adresy
Sdílené domény a vaše vlastní domény

Vybrat Pro

Business

Pro firmy s náročnou každodenní automatizací.

$99 /měsíc

150,000 poštovních schránek každých 30 dní
Až 2,000 požadavků za minutu
Žádná denní ani měsíční kvóta požadavků
Volání z jakékoli IP adresy
Sdílené domény a vaše vlastní domény

Vybrat Business

Scale

Pro velké testovací flotily a vytížené pipeline.

$199 /měsíc

400,000 poštovních schránek každých 30 dní
Až 4,000 požadavků za minutu
Žádná denní ani měsíční kvóta požadavků
Volání z jakékoli IP adresy
Sdílené domény a vaše vlastní domény

Vybrat Scale

Enterprise

Pro nejvyšší objem poštovních schránek a nejvyšší frekvenci požadavků.

$499 /měsíc

2,000,000 poštovních schránek každých 30 dní
Až 6,000 požadavků za minutu
Žádná denní ani měsíční kvóta požadavků
Volání z jakékoli IP adresy
Sdílené domény a vaše vlastní domény

Vybrat Enterprise

Porovnání plánů

Tyto limity se liší podle plánu. Všechno ostatní je na všech plánech stejné.

Porovnání plánů
Plán	Zdarma	Starter	Pro	Business	Scale	Enterprise
Měsíční cena	$0	$9	$29	$99	$199	$499
Roční cena	$0	$90	$290	$990	$1,990	$4,990
Poštovní schránky za 30 dní	100	3,000	30,000	150,000	400,000	2,000,000
Požadavky za minutu	30	300	600	2,000	4,000	6,000
Denní limit požadavků	2,000	Bez limitu	Bez limitu	Bez limitu	Bez limitu	Bez limitu
Povolené IP	Vyžadováno, 1 IP	Není potřeba	Není potřeba	Není potřeba	Není potřeba	Není potřeba
Hostovaný MCP server	Pouze lokální server	Zahrnuto	Zahrnuto	Zahrnuto	Zahrnuto	Zahrnuto

Přejetím do strany porovnáte všechny plány.

Zahrnuto v každém plánu

REST API s odpověďmi JSON
Náhodné adresy na sdílených doménách
Vlastní názvy na vašich ověřených doménách
Neomezené vlastní domény (až 3 mohou najednou čekat na ověření)
Adresy, které nevyprší
Bez omezení počtu adres, které si ponecháte
Zprávy se uchovávají 24 hodin
Extrakce jednorázových kódů a odkazů (podle možností)
Odkaz pro opětovné otevření schránky na tmailor.com
Oficiální SDK a nástroj pro příkazový řádek
Plány lze kombinovat a jejich limity se sčítají
Pouze příjem, bez příloh
Smazání adresy nevrátí kvótu

Když se vyčerpá limit schránek, nelze vytvářet nové adresy až do dalšího cyklu nebo do upgradu. Stávající schránky fungují dál.
Platby jsou nevratné podle API podmínek. Integraci si nejprve vyzkoušejte v bezplatném tarifu.

Oficiální SDK a CLI

Volejte API ze svého jazyka s typovanými modely, automatickým opakováním pokusů a pomocníkem, který počká na další zprávu. Každé SDK používá stejné API a sdílené testovací scénáře.

Python

Dostupné

Python 3.9+

pip install tmailor-sdk

Obsahuje tmailor příkazový řádek.

Zobrazit na PyPI Zdrojový kód na GitHubu

Node.js

Dostupné

Node.js 18+, TypeScript types

npm install tmailor

Zobrazit na npm Zdrojový kód na GitHubu

PHP

Dostupné

PHP 8.1+

composer require tmailor/tmailor

Zobrazit na Packagist Zdrojový kód na GitHubu

Pro AI agenty

MCP server pro AI agenty

Nechte Claude, Cursor, VS Code Copilot a další MCP klienty testovat registrační toky, které vlastníte nebo které smíte testovat: agent vytvoří skutečnou adresu pouze pro příjem, počká na e-mail a přečte jednorázový kód nebo ověřovací odkaz.

Obě možnosti dávají agentovi stejné nástroje: vytvořit adresu, počkat na e-mail a získat jeho jednorázový kód a odkazy, číst zprávy, mazat adresy a zkontrolovat kvótu. Agent vidí pouze e-mailové adresy, nikdy tokeny, které za nimi stojí, a využívá stejnou kvótu schránky a limit rychlosti jako API.

Hostovaný server

Není co instalovat

https://mcp.tmailor.com/mcp

Přidejte URL serveru do své AI aplikace. Aplikace, které podporují přihlášení, jako Claude, ChatGPT a Codex, vás přesměrují na platformu Tmailor, kde přístup schválíte. Ostatní klienti posílají váš API klíč v hlavičce Authorization.

Vyžaduje aktivní placený tarif. Požadavky přicházejí z našeho serveru, takže nepotřebujete seznam povolených IP adres.

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

Propojené aplikace najdete na stránce AI připojení a můžete je odpojit. Odpojená aplikace ztratí přístup do 30 sekund.

Zobrazit plány a limity

Lokální server

Všechny tarify, včetně Free

tmailor-mcp

Běží na vašem počítači, čte klíč z TMAILOR_API_KEY a vyžaduje uv nebo Python 3.10+. V bezplatném plánu přidejte IP adresu tohoto počítače na seznam povolených.

# 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

Zobrazit na PyPI Nastavení pro jednotlivé MCP klienty

Zkuste se zeptat: "Vytvoř dočasný e-mail, zaregistruj se s ním na mém staging webu a řekni mi ověřovací kód."

Časté dotazy k temp mail API

Co se počítá jako jedna poštovní schránka?

Každá nová adresa, kterou vytvoříte, spotřebuje jednu poštovní schránku z limitu aktuálního 30denního cyklu. Výpis, čtení a mazání schránky nespotřebovávají a smazáním adresy se schránka nevrátí.

Vyprší platnost adres?

Ne. Adresa zůstane ve vašem účtu, dokud ji nesmažete. Zprávy v ní se uchovávají 24 hodin.

Mohu posílat e-maily nebo přijímat přílohy?

Ne. API slouží pouze pro příjem a přílohy se nedoručují.

Mohu si zvolit název adresy a doménu?

Na našich sdílených doménách je název náhodný. Chcete-li název zvolit, přidejte na platformě API doménu, kterou vlastníte, a ověřte ji nastavením jejího MX záznamu na naše servery, poté vytvářejte adresy s vlastním názvem podle pravidel pojmenování.

Potřebuji seznam povolených IP adres?

Pouze u bezplatného plánu, kde přidáte jednu IP adresu, ze které váš server volá. IP adresa může patřit pouze jednomu bezplatnému účtu, takže sdílená adresa kanceláře nebo VPN už může být obsazená. S aktivním placeným plánem API přijímá požadavky z jakékoli IP adresy.

Přečte API ověřovací kód za mě?

Ano, v rámci nejlepšího úsilí. Při čtení zprávy odpověď obsahuje nalezený jednorázový kód (nebo null, pokud si není jistá), další hodnoty podobné kódu a odkazy. Hodnotu si ve svém testu vždy ověřte.

Mohou AI agenti jako Claude nebo ChatGPT používat API?

Ano, prostřednictvím MCP. U placeného plánu přidejte do své AI aplikace hostovaný server https://mcp.tmailor.com/mcp a schvalte přístup, nebo odešlete svůj API klíč. U jakéhokoli plánu můžete spustit open-source server tmailor-mcp na vlastním počítači. V obou případech může agent vytvořit adresu, počkat na e-mail a přečíst jednorázový kód, přičemž využívá stejnou kvótu poštovních schránek jako API.

Mají placené plány limit požadavků?

Placené plány nemají denní ani měsíční kvótu požadavků, ale každý plán má limit požadavků za minutu. Bezplatný plán má navíc denní limit požadavků.

Potřebuji k začátku kreditní kartu?

Ne. Přihlaste se účtem tmailor.com nebo přes Google, vytvořte klíč a začněte na bezplatném plánu. Platíte až tehdy, když si zvolíte placený plán.

Jak mohu zaplatit za plán?

Plaťte USDT v síti TRC20 (Tron) nebo BEP20 (BNB Smart Chain), případně přes Binance Pay. Kreditní a debetní karty nejsou přijímány. Váš plán se aktivuje po potvrzení platby, obvykle během několika minut.

Mohu získat vrácení peněz?

Ne. Platby jsou nevratné, proto si integraci před upgradem otestujte na bezplatném plánu.

K čemu se API nesmí používat?

Spam, podvody, hromadné vytváření účtů na jiných službách a obcházení jejich banů nebo limitů porušují podmínky API. Účtům, které to dělají, můžeme zrušit API klíče a zablokovat je.

Vytvořte si první adresu během několika minut

Začněte s tarifem Free s 100 schránkami měsíčně. Kreditní karta není potřeba.

Začněte zdarma Přečtěte si dokumentaci API

Temp Mail API pro testování a automatizaci

Plaťte za schránku, ne za požadavek

Od API klíče ke schránce ve čtyřech krocích

Vytvořte API klíč

Vytvořte adresu

Přečtěte si zprávy

Nechte si ji, nebo ji smažte

Vytvořeno pro opakovatelné e-mailové postupy

Registrace a OTP testy

CI/CD pipeline

QA a staging

Adresy na vaší vlastní doméně

Tarify a ceny

Zdarma

Starter

Pro

Business

Scale

Enterprise

Porovnání plánů

Zahrnuto v každém plánu

Oficiální SDK a CLI

Python

Node.js

PHP

MCP server pro AI agenty

Hostovaný server

Lokální server

Časté dotazy k temp mail API

Vytvořte si první adresu během několika minut