Tmailor Open API

API de email temporar pentru testare și automatizare

Creează din codul tău adrese de email temporare care doar primesc mesaje și citește mesajele primite ca JSON. Fiecare adresă rămâne în contul tău Tmailor până când o ștergi, iar API-ul returnează codul unic pe care îl găsește într-un mesaj.

Ultima actualizare: October 2026

Începe gratuit Citește documentația API

Vezi planurile și limitele

REST și JSON
SDK-uri, CLI și server MCP
100 cutii poștale gratuite pe lună
Doar recepționare, mesaje păstrate 24 de ore

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;

Creează o adresă, așteaptă emailul, citește codul.

Plătești pe cutie poștală, nu pe cerere

Doar crearea unei adrese consumă din cota de cutii poștale. Listarea adreselor, verificarea inboxului și citirea sau ștergerea mesajelor nu consumă din cotă. Planurile plătite nu au o cotă zilnică sau lunară de cereri, ci doar o limită de cereri pe minut.

Exemplu: un test OTP care creează o adresă și verifică inboxul de 25 de ori consumă o singură cutie poștală.

De la cheia API la inbox în patru pași

Creează o cheie API
Conectează-te la platforma API cu contul tău tmailor.com sau cu Google și creează o cheie. În planul gratuit, adaugă și unica adresă IP a serverului care va apela API-ul.
Creează o adresă
Trimite o singură cerere pentru a obține o adresă aleatorie pe un domeniu partajat sau alege un nume personalizat pe un domeniu pe care îl deții și pe care l-ai verificat.
Citește mesajele
Listează inbox-ul și citește fiecare mesaj ca JSON: expeditor, subiect, text, HTML curățat, plus codul unic și linkurile găsite de API.
Păstrează-l sau șterge-l
Adresele nu expiră. Deschide același inbox pe tmailor.com cu linkul de reutilizare sau șterge adresa când ai terminat testul.

Creat pentru fluxuri de e-mail repetabile

Oferă fiecărei rulări de test propria căsuță de e-mail, în loc să împărțiți o singură cutie poștală reală.

Înregistrare și teste OTP

Creează o adresă nouă pentru fiecare înregistrare, resetare de parolă sau verificare de cod unic, apoi citește codul din răspuns.

Pipeline-uri CI/CD

Rulează verificări de e-mail end-to-end în pipeline-ul tău, cu cheia într-o variabilă de mediu. Planurile plătite acceptă cereri de la orice adresă IP.

QA și staging

Oferă testerilor și mediilor de staging propriile adrese și ține cutiile poștale reale departe de datele de test.

Adrese pe propriul domeniu

Adaugă un domeniu pe care îl deții, îndreaptă înregistrarea MX către noi și creează adrese cu nume personalizate care respectă regulile de denumire.

Planuri și prețuri

Alege numărul de cutii poștale de care ai nevoie. Alocația se reînnoiește la fiecare 30 de zile, inclusiv la planurile anuale.

Gratuit

Încearcă API-ul și rulează proiecte mici.

$0 /lună

100 cutii poștale la fiecare 30 de zile
Până la 30 cereri pe minut
2,000 cereri pe zi
Apeluri de pe un singur IP permis
Domenii partajate și propriile tale domenii

Începe gratuit

Starter

Pentru un dezvoltator sau o suită mică de teste.

$9 /lună

3,000 cutii poștale la fiecare 30 de zile
Până la 300 cereri pe minut
Fără cotă zilnică sau lunară de cereri
Apeluri de pe orice adresă IP
Domenii partajate și propriile tale domenii

Alege Starter

Pro

Pentru echipele care rulează teste zilnic.

$29 /lună

30,000 cutii poștale la fiecare 30 de zile
Până la 600 cereri pe minut
Fără cotă zilnică sau lunară de cereri
Apeluri de pe orice adresă IP
Domenii partajate și propriile tale domenii

Alege Pro

Business

Pentru companiile cu automatizări zilnice intense.

$99 /lună

150,000 cutii poștale la fiecare 30 de zile
Până la 2,000 cereri pe minut
Fără cotă zilnică sau lunară de cereri
Apeluri de pe orice adresă IP
Domenii partajate și propriile tale domenii

Alege Business

Scale

Pentru flote mari de teste și pipeline-uri aglomerate.

$199 /lună

400,000 cutii poștale la fiecare 30 de zile
Până la 4,000 cereri pe minut
Fără cotă zilnică sau lunară de cereri
Apeluri de pe orice adresă IP
Domenii partajate și propriile tale domenii

Alege Scale

Enterprise

Pentru cel mai mare volum de cutii poștale și cea mai mare rată de cereri.

$499 /lună

2,000,000 cutii poștale la fiecare 30 de zile
Până la 6,000 cereri pe minut
Fără cotă zilnică sau lunară de cereri
Apeluri de pe orice adresă IP
Domenii partajate și propriile tale domenii

Alege Enterprise

Compară planurile

Aceste limite diferă de la un plan la altul. În rest, totul este la fel pe fiecare plan.

Compară planurile
Plan	Gratuit	Starter	Pro	Business	Scale	Enterprise
Preț lunar	$0	$9	$29	$99	$199	$499
Preț anual	$0	$90	$290	$990	$1,990	$4,990
Cutii poștale la fiecare 30 de zile	100	3,000	30,000	150,000	400,000	2,000,000
Cereri pe minut	30	300	600	2,000	4,000	6,000
Limită zilnică de cereri	2,000	Fără limită	Fără limită	Fără limită	Fără limită	Fără limită
Listă de IP-uri permise	Obligatoriu, 1 IP	Nu este necesar	Nu este necesar	Nu este necesar	Nu este necesar	Nu este necesar
Server MCP găzduit	Doar server local	Inclus	Inclus	Inclus	Inclus	Inclus

Glisează lateral pentru a compara toate planurile.

Inclus în fiecare plan

API REST cu răspunsuri JSON
Adrese aleatorii pe domenii partajate
Nume personalizate pe domeniile tale verificate
Domenii proprii nelimitate (până la 3 pot fi în așteptarea verificării simultan)
Adrese care nu expiră
Fără limită la numărul de adrese pe care le păstrezi
Mesajele sunt păstrate 24 de ore
Extragerea codului unic și a linkurilor (best effort)
Un link de reutilizare pentru a deschide inbox-ul pe tmailor.com
SDK-uri oficiale și un instrument de linie de comandă
Planurile pot fi combinate, iar limitele lor se adună
Doar primire, fără atașamente
Ștergerea unei adrese nu returnează cotă

Când alocația de cutii poștale este epuizată, nu pot fi create adrese noi până la următorul ciclu sau până la un upgrade. Inbox-urile existente continuă să funcționeze.
Plățile nu sunt rambursabile conform termenilor API. Testează-ți integrarea mai întâi pe planul gratuit.

SDK-uri oficiale și CLI

Apelează API-ul din limbajul tău preferat, cu modele tipizate, reîncercări automate și un helper care așteaptă următorul mesaj. Fiecare SDK respectă același API și aceleași scenarii de testare comune.

Python

Disponibil

Python 3.9+

pip install tmailor-sdk

Include tmailor.

Vezi pe PyPI Cod sursă pe GitHub

Node.js

Disponibil

Node.js 18+, TypeScript types

npm install tmailor

Vezi pe npm Cod sursă pe GitHub

PHP

Disponibil

PHP 8.1+

composer require tmailor/tmailor

Vezi pe Packagist Cod sursă pe GitHub

Pentru agenții AI

Server MCP pentru agenții AI

Permite clienților Claude, Cursor, VS Code Copilot și altor clienți MCP să testeze fluxuri de înregistrare pe care le deții sau pe care ai voie să le testezi: agentul creează o adresă reală, doar pentru recepție, așteaptă e-mailul și citește codul unic sau linkul de verificare.

Ambele opțiuni îi oferă agentului aceleași instrumente: creează o adresă, așteaptă e-mailul și obține codul unic și linkurile acestuia, citește mesajele, șterge adresele și verifică cota. Agentul vede doar adresele de e-mail, niciodată tokenurile din spatele lor, și folosește aceeași cotă de cutie poștală și aceeași limită de rată ca API-ul.

Server găzduit

Nimic de instalat

https://mcp.tmailor.com/mcp

Adaugă URL-ul serverului în aplicația ta AI. Aplicațiile care acceptă autentificarea, precum Claude, ChatGPT și Codex, te redirecționează către platforma Tmailor pentru a aproba accesul. Alți clienți trimit cheia ta API în headerul Authorization.

Necesită un plan plătit activ. Apelurile provin de pe serverul nostru, așa că nu ai nevoie de o listă de IP-uri permise.

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

Vezi aplicațiile conectate pe pagina AI connection și deconectează oricare dintre ele. O aplicație deconectată pierde accesul în 30 de secunde.

Vezi planurile și limitele

Server local

Toate planurile, inclusiv gratuit

tmailor-mcp

Rulează pe calculatorul tău, citește cheia din TMAILOR_API_KEY și necesită uv sau Python 3.10+. Pe planul gratuit, adaugă IP-ul acelui calculator în lista de IP-uri permise.

# 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

Vezi pe PyPI Configurare pentru fiecare client MCP

Încearcă să întrebi: "Creează un e-mail temporar, înregistrează-te cu el pe site-ul meu de staging și spune-mi codul de verificare."

Întrebări frecvente despre API-ul de mail temporar

Ce se consideră o cutie poștală?

Fiecare adresă nouă pe care o creezi consumă o cutie poștală din limita ciclului actual de 30 de zile. Listarea, citirea și ștergerea nu consumă cutii poștale, iar ștergerea unei adrese nu îți returnează cutia poștală.

Adresele expiră?

Nu. O adresă rămâne în contul tău până când o ștergi. Mesajele din ea sunt păstrate timp de 24 de ore.

Pot trimite emailuri sau primi atașamente?

Nu. API-ul doar primește emailuri, iar atașamentele nu sunt livrate.

Pot alege numele adresei și domeniul?

Pe domeniile noastre comune, numele este aleatoriu. Pentru a alege numele, adaugă și verifică pe platforma API un domeniu pe care îl deții, îndreptând înregistrarea MX către noi, apoi creează adrese cu un nume personalizat care respectă regulile de denumire.

Am nevoie de o listă de IP-uri permise?

Doar pe planul gratuit, unde adaugi adresa IP de la care apelează serverul tău. O adresă IP poate aparține unui singur cont gratuit, așa că o adresă partajată de birou sau VPN poate fi deja folosită. Cu un plan plătit activ, API-ul acceptă cereri de la orice adresă IP.

API-ul citește codul de verificare în locul meu?

Da, în măsura posibilului. Când citești un mesaj, răspunsul include codul de unică folosință găsit (sau null când nu este sigur), alte valori asemănătoare unui cod și linkurile. Verifică întotdeauna valoarea în testul tău.

Pot agenții AI precum Claude sau ChatGPT să folosească API-ul?

Da, prin MCP. Pe un plan plătit, adaugă serverul găzduit https://mcp.tmailor.com/mcp în aplicația ta AI și aprobă accesul, sau trimite cheia ta API. Pe orice plan, poți rula serverul open-source tmailor-mcp pe propriul calculator. În ambele cazuri, agentul poate crea o adresă, poate aștepta emailul și poate citi codul de unică folosință, folosind aceeași cotă de cutii poștale ca API-ul.

Există o limită de cereri pentru planurile plătite?

Planurile plătite nu au o cotă zilnică sau lunară de cereri, dar fiecare plan are o limită de cereri pe minut. Planul gratuit are, de asemenea, o limită zilnică de cereri.

Am nevoie de un card de credit pentru a începe?

Nu. Autentifică-te cu contul tău tmailor.com sau cu Google, creează o cheie și începe cu planul gratuit. Plătești doar când alegi un plan plătit.

Cum pot plăti pentru un plan?

Plătește cu USDT în rețeaua TRC20 (Tron) sau BEP20 (BNB Smart Chain), sau cu Binance Pay. Cardurile de credit și de debit nu sunt acceptate. Planul tău devine activ când plata este confirmată, de obicei în câteva minute.

Pot primi o rambursare?

Nu. Plățile nu sunt rambursabile, așa că testează-ți integrarea pe planul gratuit înainte de a face upgrade.

Pentru ce nu este permis API-ul?

Spamul, frauda, crearea de conturi în masă pe alte servicii și eludarea interdicțiilor sau limitărilor acestora încalcă termenii API-ului. Putem revoca cheile API ale conturilor care fac acest lucru și le putem bloca.

Creează-ți prima adresă în câteva minute

Începe cu planul gratuit, cu 100 căsuțe poștale pe lună. Nu este nevoie de card de credit.

Începe gratuit Citește documentația API

API de email temporar pentru testare și automatizare

Plătești pe cutie poștală, nu pe cerere

De la cheia API la inbox în patru pași

Creează o cheie API

Creează o adresă

Citește mesajele

Păstrează-l sau șterge-l

Creat pentru fluxuri de e-mail repetabile

Înregistrare și teste OTP

Pipeline-uri CI/CD

QA și staging

Adrese pe propriul domeniu

Planuri și prețuri

Gratuit

Starter

Pro

Business

Scale

Enterprise

Compară planurile

Inclus în fiecare plan

SDK-uri oficiale și CLI

Python

Node.js

PHP

Server MCP pentru agenții AI

Server găzduit

Server local

Întrebări frecvente despre API-ul de mail temporar

Creează-ți prima adresă în câteva minute