Tmailor Open API

Tymczasowe API poczty do testów i automatyzacji

Twórz w kodzie tymczasowe adresy e-mail tylko do odbioru i odczytuj przychodzące wiadomości jako JSON. Każdy adres pozostaje na Twoim koncie Tmailor aż do usunięcia, a API zwraca jednorazowy kod znaleziony w wiadomości.

Ostatnia aktualizacja: October 2026

Zacznij za darmo Przeczytaj dokumentację API

Zobacz plany i limity

REST i JSON
SDK, CLI i serwer MCP
100 darmowych skrzynek pocztowych miesięcznie
Tylko odbiór, wiadomości przez 24 godziny

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;

Utwórz adres, poczekaj na e-mail, odczytaj kod.

Płać za skrzynkę, nie za żądanie

Limit skrzynki zużywa wyłącznie utworzenie adresu. Wyświetlanie adresów, sprawdzanie skrzynki odbiorczej oraz czytanie i usuwanie wiadomości nie zużywają go. Plany płatne nie mają dziennego ani miesięcznego limitu żądań, jedynie limit na minutę.

Przykład: test OTP, który tworzy jeden adres i sprawdza skrzynkę odbiorczą 25 razy, zużywa jedną skrzynkę.

Od klucza API do skrzynki odbiorczej w czterech krokach

Utwórz klucz API
Zaloguj się na platformę API za pomocą konta tmailor.com lub Google i utwórz klucz. W planie darmowym dodaj też jeden adres IP serwera, który będzie wywoływać API.
Utwórz adres
Wyślij jedno żądanie, aby otrzymać losowy adres na domenie współdzielonej, lub wybierz własną nazwę na domenie, którą posiadasz i zweryfikowałeś.
Odczytaj wiadomości
Wyświetl listę skrzynki odbiorczej i odczytaj każdą wiadomość jako JSON: nadawca, temat, tekst, oczyszczony HTML oraz jednorazowy kod i linki znalezione przez API.
Zachowaj lub usuń
Adresy nie wygasają. Otwórz tę samą skrzynkę odbiorczą na tmailor.com za pomocą linku do ponownego użycia lub usuń adres po zakończeniu testu.

Stworzone do powtarzalnych procesów e-mailowych

Każde uruchomienie testu otrzymuje własną skrzynkę odbiorczą zamiast współdzielonej prawdziwej skrzynki.

Testy rejestracji i OTP

Utwórz nowy adres dla każdej rejestracji, resetu hasła lub sprawdzenia jednorazowego kodu, a następnie odczytaj kod z odpowiedzi.

Potoki CI/CD

Uruchamiaj kompleksowe testy e-mail w swoim potoku, umieszczając klucz w zmiennej środowiskowej. Plany płatne akceptują żądania z dowolnego adresu IP.

QA i środowiska testowe

Przydziel testerom i środowiskom testowym własne adresy i trzymaj prawdziwe skrzynki poza danymi testowymi.

Adresy we własnej domenie

Dodaj domenę, którą posiadasz, wskaż nam jej rekord MX i twórz adresy z niestandardowymi nazwami zgodnymi z zasadami nazewnictwa.

Plany i ceny

Wybierz liczbę skrzynek pocztowych, których potrzebujesz. Limit odnawia się co 30 dni, również w planach rocznych.

Free

Wypróbuj API i realizuj małe projekty.

$0 /miesiąc

100 skrzynek pocztowych co 30 dni
Do 30 żądań na minutę
2,000 żądań dziennie
Wywołania z jednego adresu IP z listy dozwolonych
Domeny współdzielone i własne domeny

Zacznij za darmo

Starter

Dla jednego programisty lub małego zestawu testów.

$9 /miesiąc

3,000 skrzynek pocztowych co 30 dni
Do 300 żądań na minutę
Brak dziennego i miesięcznego limitu żądań
Wywołania z dowolnego adresu IP
Domeny współdzielone i własne domeny

Wybierz plan Starter

Pro

Dla zespołów, które codziennie uruchamiają testy.

$29 /miesiąc

30,000 skrzynek pocztowych co 30 dni
Do 600 żądań na minutę
Brak dziennego i miesięcznego limitu żądań
Wywołania z dowolnego adresu IP
Domeny współdzielone i własne domeny

Wybierz plan Pro

Business

Dla firm z intensywną codzienną automatyzacją.

$99 /miesiąc

150,000 skrzynek pocztowych co 30 dni
Do 2,000 żądań na minutę
Brak dziennego i miesięcznego limitu żądań
Wywołania z dowolnego adresu IP
Domeny współdzielone i własne domeny

Wybierz plan Business

Scale

Dla dużych zestawów testów i intensywnych potoków CI.

$199 /miesiąc

400,000 skrzynek pocztowych co 30 dni
Do 4,000 żądań na minutę
Brak dziennego i miesięcznego limitu żądań
Wywołania z dowolnego adresu IP
Domeny współdzielone i własne domeny

Wybierz plan Scale

Enterprise

Dla największego wolumenu skrzynek pocztowych i najwyższego limitu żądań.

$499 /miesiąc

2,000,000 skrzynek pocztowych co 30 dni
Do 6,000 żądań na minutę
Brak dziennego i miesięcznego limitu żądań
Wywołania z dowolnego adresu IP
Domeny współdzielone i własne domeny

Wybierz plan Enterprise

Porównanie planów

Te limity różnią się w zależności od planu. Wszystko inne jest takie samo w każdym planie.

Porównanie planów
Plan	Free	Starter	Pro	Business	Scale	Enterprise
Cena miesięczna	$0	$9	$29	$99	$199	$499
Cena roczna	$0	$90	$290	$990	$1,990	$4,990
Skrzynki co 30 dni	100	3,000	30,000	150,000	400,000	2,000,000
Żądania na minutę	30	300	600	2,000	4,000	6,000
Dzienny limit żądań	2,000	Bez limitu	Bez limitu	Bez limitu	Bez limitu	Bez limitu
Lista dozwolonych IP	Wymagane, 1 IP	Niewymagane	Niewymagane	Niewymagane	Niewymagane	Niewymagane
Hostowany serwer MCP	Tylko serwer lokalny	Uwzględnione	Uwzględnione	Uwzględnione	Uwzględnione	Uwzględnione

Przesuń na bok, aby porównać wszystkie plany.

W każdym planie

API REST z odpowiedziami JSON
Losowe adresy na współdzielonych domenach
Własne nazwy na własnych zweryfikowanych domenach
Nieograniczona liczba własnych domen (do 3 mogą jednocześnie czekać na weryfikację)
Adresy, które nie wygasają
Bez limitu liczby przechowywanych adresów
Wiadomości są przechowywane przez 24 godziny
Wyodrębnianie jednorazowych kodów i linków (w miarę możliwości)
Link do otwarcia skrzynki odbiorczej na tmailor.com
Oficjalne SDK i narzędzie wiersza poleceń
Plany można łączyć, a ich limity się sumują
Tylko odbieranie, bez załączników
Usunięcie adresu nie zwraca limitu

Gdy limit skrzynek zostanie wyczerpany, nie można tworzyć nowych adresów aż do następnego cyklu lub do zmiany planu na wyższy. Istniejące skrzynki nadal działają.
Płatności nie podlegają zwrotowi zgodnie z API terms. Najpierw przetestuj integrację w darmowym planie.

Oficjalne SDK i CLI

Wywołuj API ze swojego języka dzięki typowanym modelom, automatycznym ponowieniom i pomocnikowi, który czeka na kolejną wiadomość. Każde SDK działa na tym samym API i przechodzi te same wspólne scenariusze testowe.

Python

Dostępne

Python 3.9+

pip install tmailor-sdk

Zawiera tmailor.

Zobacz w PyPI Kod źródłowy na GitHub

Node.js

Dostępne

Node.js 18+, TypeScript types

npm install tmailor

Zobacz w npm Kod źródłowy na GitHub

PHP

Dostępne

PHP 8.1+

composer require tmailor/tmailor

Zobacz w Packagist Kod źródłowy na GitHub

Dla agentów AI

Serwer MCP dla agentów AI

Pozwól Claude, Cursor, VS Code Copilot i innym klientom MCP testować przepływy rejestracji, których jesteś właścicielem lub które możesz testować: agent tworzy prawdziwy adres tylko do odbioru, czeka na e-mail i odczytuje jednorazowy kod lub link weryfikacyjny.

Obie opcje dają agentowi te same narzędzia: utworzenie adresu, oczekiwanie na e-mail i pobranie jego jednorazowego kodu oraz linków, odczytywanie wiadomości, usuwanie adresów i sprawdzanie limitu. Agent widzi tylko adresy e-mail, nigdy stojące za nimi tokeny, a jego użycie liczy się do tego samego limitu skrzynki i limitu zapytań co API.

Serwer hostowany

Nic do zainstalowania

https://mcp.tmailor.com/mcp

Dodaj adres URL serwera do swojej aplikacji AI. Aplikacje obsługujące logowanie, takie jak Claude, ChatGPT i Codex, przenoszą Cię na platformę Tmailor, aby zatwierdzić dostęp. Inni klienci przesyłają Twój klucz API w nagłówku Authorization.

Wymaga aktywnego płatnego planu. Połączenia wychodzą z naszego serwera, więc nie musisz dodawać adresów IP do listy dozwolonych.

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

Zobacz połączone aplikacje na stronie AI connections i rozłącz dowolną z nich. Rozłączona aplikacja traci dostęp w ciągu 30 sekund.

Zobacz plany i limity

Serwer lokalny

Każdy plan, w tym darmowy

tmailor-mcp

Działa na Twoim komputerze, odczytuje klucz z TMAILOR_API_KEY i wymaga uv lub Pythona 3.10+. W planie darmowym dodaj adres IP tego komputera do listy dozwolonych.

# 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

Zobacz w PyPI Konfiguracja dla każdego klienta MCP

Spróbuj zapytać: "Utwórz tymczasowy e-mail, zarejestruj się nim na mojej stronie testowej i podaj mi kod weryfikacyjny."

Najczęstsze pytania o tymczasowe API poczty

Co liczy się jako skrzynka pocztowa?

Każdy nowy adres, który utworzysz, zajmuje jedną skrzynkę pocztową z limitu obowiązującego w bieżącym 30-dniowym cyklu. Wyświetlanie listy, odczytywanie i usuwanie nie zużywają skrzynek pocztowych, a usunięcie adresu nie zwraca skrzynki pocztowej.

Czy adresy wygasają?

Nie. Adres pozostaje na Twoim koncie, dopóki go nie usuniesz. Wiadomości w nim są przechowywane przez 24 godziny.

Czy mogę wysyłać e-maile lub odbierać załączniki?

Nie. API służy wyłącznie do odbierania, a załączniki nie są dostarczane.

Czy mogę wybrać nazwę adresu i domenę?

W naszych współdzielonych domenach nazwa jest losowa. Aby wybrać nazwę, dodaj i zweryfikuj na platformie API własną domenę, wskazując jej rekord MX na nasze serwery, a następnie twórz adresy z niestandardową nazwą zgodną z zasadami nazewnictwa.

Czy potrzebuję listy dozwolonych adresów IP?

Tylko w planie darmowym, w którym dodajesz jeden adres IP, z którego wywołuje twój serwer. Adres IP może należeć tylko do jednego konta Free, więc współdzielony adres biurowy lub VPN może być już zajęty. W przypadku aktywnego planu płatnego API akceptuje żądania z dowolnego adresu IP.

Czy API odczytuje za mnie kod weryfikacyjny?

Tak, w miarę możliwości. Gdy odczytujesz wiadomość, odpowiedź zawiera znaleziony jednorazowy kod (lub null, gdy nie ma pewności), inne wartości przypominające kod oraz linki. Zawsze sprawdzaj wartość w swoim teście.

Czy agenci AI, tacy jak Claude czy ChatGPT, mogą korzystać z API?

Tak, przez MCP. W planie płatnym dodaj hostowany serwer https://mcp.tmailor.com/mcp do swojej aplikacji AI i zatwierdź dostęp lub podaj swój klucz API. W każdym planie możesz uruchomić otwartoźródłowy serwer tmailor-mcp na własnym komputerze. W obu przypadkach agent może utworzyć adres, poczekać na e-mail i odczytać jednorazowy kod, korzystając z tego samego limitu skrzynek pocztowych co API.

Czy w planach płatnych obowiązuje limit żądań?

Plany płatne nie mają dziennego ani miesięcznego limitu żądań, ale każdy plan ma limit liczby żądań na minutę. Plan darmowy ma dodatkowo dzienny limit żądań.

Czy potrzebuję karty kredytowej, żeby zacząć?

Nie. Zaloguj się za pomocą konta tmailor.com lub Google, utwórz klucz i zacznij od planu darmowego. Płacisz tylko wtedy, gdy wybierzesz plan płatny.

Jak mogę zapłacić za plan?

Zapłać w USDT w sieci TRC20 (Tron) lub BEP20 (BNB Smart Chain) albo za pomocą Binance Pay. Karty kredytowe i debetowe nie są akceptowane. Twój plan aktywuje się po potwierdzeniu płatności, zwykle w ciągu kilku minut.

Czy mogę otrzymać zwrot pieniędzy?

Nie. Płatności nie podlegają zwrotowi, więc przed przejściem na wyższy plan przetestuj integrację w planie darmowym.

Do czego nie wolno używać API?

Spam, oszustwa, masowe zakładanie kont w innych usługach oraz omijanie ich blokad lub limitów naruszają warunki API. Możemy cofnąć klucze API kont, które to robią, i zablokować takie konta.

Stwórz swój pierwszy adres w kilka minut

Zacznij od darmowego planu z 100 skrzynkami miesięcznie. Karta kredytowa nie jest wymagana.

Zacznij za darmo Przeczytaj dokumentację API

Tymczasowe API poczty do testów i automatyzacji

Płać za skrzynkę, nie za żądanie

Od klucza API do skrzynki odbiorczej w czterech krokach

Utwórz klucz API

Utwórz adres

Odczytaj wiadomości

Zachowaj lub usuń

Stworzone do powtarzalnych procesów e-mailowych

Testy rejestracji i OTP

Potoki CI/CD

QA i środowiska testowe

Adresy we własnej domenie

Plany i ceny

Free

Starter

Pro

Business

Scale

Enterprise

Porównanie planów

W każdym planie

Oficjalne SDK i CLI

Python

Node.js

PHP

Serwer MCP dla agentów AI

Serwer hostowany

Serwer lokalny

Najczęstsze pytania o tymczasowe API poczty

Stwórz swój pierwszy adres w kilka minut