Tmailor Open API

API ya Barua Pepe za Muda kwa Upimaji na Uendeshaji

Tengeneza anwani za barua pepe za muda zinazopokea tu kupitia msimbo wako, na usome ujumbe unaoingia kama JSON. Kila anwani hubaki kwenye akaunti yako ya Tmailor hadi uifute, na API hurudisha msimbo wa mara moja inaoupata kwenye ujumbe.

Ilisasishwa mara ya mwisho: October 2026

Anza bure Soma hati za API

Tazama mipango na mipaka

REST na JSON
SDK, CLI na seva ya MCP
Sanduku 100 la barua bila malipo kwa mwezi
Kupokea tu, ujumbe hudumu saa 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;

Unda anwani, subiri barua pepe, soma msimbo.

Lipa kwa kila sanduku la barua, si kwa kila ombi

Ni kuunda anwani tu kunatumia kiwango chako cha masanduku ya barua. Kuorodhesha anwani, kuangalia kikasha, na kusoma au kufuta ujumbe hakutumii. Mipango ya malipo haina kiwango cha maombi cha kila siku au kila mwezi, bali kikomo cha kasi cha kila dakika tu.

Mfano: jaribio la OTP linalounda anwani moja na kukagua kikasha mara 25 linatumia sanduku moja la barua.

Kutoka ufunguo wa API hadi kikasha katika hatua nne

Unda ufunguo wa API
Ingia kwenye jukwaa la API ukitumia akaunti yako ya tmailor.com au Google kisha uunde ufunguo. Kwenye mpango wa Bure, pia ongeza anwani moja ya IP ya seva ambayo itaita API.
Unda anwani
Tuma ombi moja kupata anwani ya nasibu kwenye kikoa kinachoshirikiwa, au chagua jina maalum kwenye kikoa unachomiliki na ulichothibitisha.
Soma ujumbe
Orodhesha kikasha na usome kila ujumbe kama JSON: mtumaji, kichwa, maandishi, HTML iliyosafishwa, pamoja na msimbo wa mara moja na viungo vilivyopatikana na API.
Ihifadhi au uifute
Anwani hazimaliziki muda wake. Fungua kikasha hicho hicho kwenye tmailor.com kwa kiungo chake cha kutumia tena, au futa anwani hiyo baada ya jaribio lako kukamilika.

Imeundwa kwa mtiririko wa barua pepe unaorudiwa

Toa kila jaribio la majaribio kikasha chake badala ya kushiriki kisanduku kimoja halisi.

Majisajili na majaribio ya OTP

Unda anwani mpya kwa kila usajili, uwekaji upya wa nenosiri au ukaguzi wa msimbo wa mara moja, kisha soma msimbo huo kutoka kwenye jibu.

Mabomba ya CI/CD

Endesha ukaguzi wa barua pepe wa mwanzo hadi mwisho kwenye bomba lako ukitumia ufunguo uliowekwa katika kigezo cha mazingira. Mipango ya kulipia inakubali maombi kutoka anwani yoyote ya IP.

QA na mazingira ya majaribio

Wape wanaojaribu na mazingira ya majaribio anwani zao wenyewe na uweke vikasha halisi nje ya data ya majaribio.

Anwani kwenye kikoa chako mwenyewe

Ongeza kikoa unachomiliki, elekeza rekodi yake ya MX kwetu na uunde anwani zenye majina maalum yanayofuata sheria za uundaji majina.

Mipango na bei

Chagua idadi ya visanduku vya barua unavyohitaji. Kiasi chako hurejeshwa kila siku 30, hata kwenye mipango ya malipo ya kila mwaka.

Bure

Jaribu API na uendeshe miradi midogo.

$0 /mwezi

Sanduku la barua 100 kila siku 30
Hadi maombi 30 kwa dakika
Maombi 2,000 kwa siku
Maombi kutoka kwa IP moja iliyoruhusiwa
Vikoa vya pamoja na vikoa vyako mwenyewe

Anza bure

Starter

Kwa msanidi programu mmoja au majaribio machache ya kiotomatiki.

$9 /mwezi

Sanduku la barua 3,000 kila siku 30
Hadi maombi 300 kwa dakika
Hakuna kikomo cha maombi kwa siku au kwa mwezi
Maombi kutoka kwa anwani yoyote ya IP
Vikoa vya pamoja na vikoa vyako mwenyewe

Chagua Starter

Pro

Kwa timu zinazofanya majaribio kila siku.

$29 /mwezi

Sanduku la barua 30,000 kila siku 30
Hadi maombi 600 kwa dakika
Hakuna kikomo cha maombi kwa siku au kwa mwezi
Maombi kutoka kwa anwani yoyote ya IP
Vikoa vya pamoja na vikoa vyako mwenyewe

Chagua Pro

Business

Kwa kampuni zinazotumia otomatiki nyingi kila siku.

$99 /mwezi

Sanduku la barua 150,000 kila siku 30
Hadi maombi 2,000 kwa dakika
Hakuna kikomo cha maombi kwa siku au kwa mwezi
Maombi kutoka kwa anwani yoyote ya IP
Vikoa vya pamoja na vikoa vyako mwenyewe

Chagua Business

Scale

Kwa majaribio mengi yanayofanyika kwa wakati mmoja na pipelines zenye shughuli nyingi.

$199 /mwezi

Sanduku la barua 400,000 kila siku 30
Hadi maombi 4,000 kwa dakika
Hakuna kikomo cha maombi kwa siku au kwa mwezi
Maombi kutoka kwa anwani yoyote ya IP
Vikoa vya pamoja na vikoa vyako mwenyewe

Chagua Scale

Enterprise

Kwa kiasi kikubwa zaidi cha sanduku la barua na kiwango cha juu zaidi cha maombi.

$499 /mwezi

Sanduku la barua 2,000,000 kila siku 30
Hadi maombi 6,000 kwa dakika
Hakuna kikomo cha maombi kwa siku au kwa mwezi
Maombi kutoka kwa anwani yoyote ya IP
Vikoa vya pamoja na vikoa vyako mwenyewe

Chagua Enterprise

Linganisha mipango

Mipaka hii inatofautiana kati ya mipango. Mambo mengine yote ni sawa katika kila mpango.

Linganisha mipango
Mpango	Bure	Starter	Pro	Business	Scale	Enterprise
Bei ya kila mwezi	$0	$9	$29	$99	$199	$499
Bei ya kila mwaka	$0	$90	$290	$990	$1,990	$4,990
Sanduku la barua kila siku 30	100	3,000	30,000	150,000	400,000	2,000,000
Maombi kwa dakika	30	300	600	2,000	4,000	6,000
Kikomo cha maombi kwa siku	2,000	Hakuna kikomo	Hakuna kikomo	Hakuna kikomo	Hakuna kikomo	Hakuna kikomo
Orodha ya IP zinazoruhusiwa	Inahitajika, IP 1	Haihitajiki	Haihitajiki	Haihitajiki	Haihitajiki	Haihitajiki
Seva ya MCP inayopangishwa	Seva ya ndani pekee	Imejumuishwa	Imejumuishwa	Imejumuishwa	Imejumuishwa	Imejumuishwa

Telezesha kando ili kulinganisha mipango yote.

Imejumuishwa katika kila mpango

API ya REST yenye majibu ya JSON
Anwani nasibu kwenye vikoa vinavyoshirikiwa
Majina maalum kwenye vikoa vyako vilivyothibitishwa
Vikoa vyako visivyo na kikomo (hadi 3 vinaweza kusubiri uthibitishaji kwa wakati mmoja)
Anwani zisizoisha muda
Hakuna kikomo cha idadi ya anwani unazohifadhi
Ujumbe huhifadhiwa kwa masaa 24
Uchimbaji wa msimbo wa mara moja na viungo (kwa juhudi bora)
Kiungo cha kufungua kikasha kwenye tmailor.com
SDK rasmi na zana ya mstari wa amri
Mipango inaweza kuunganishwa na mipaka yake inajumlishwa
Kupokea tu, bila viambatisho
Kufuta anwani hakurudishi kiwango

Kiwango cha visanduku vya barua kinapokwisha, anwani mpya haziwezi kuundwa hadi mzunguko unaofuata au hadi uboreshaji. Visanduku vilivyopo vinaendelea kufanya kazi.
Malipo hayarejeshwi chini ya masharti ya API. Jaribu ujumuishaji wako kwenye mpango wa bure kwanza.

SDK rasmi na CLI

Ita API kutoka kwa lugha yako mwenyewe ukitumia miundo yenye aina, majaribio ya kiotomatiki ya kujaribu tena na msaidizi anayesubiri ujumbe unaofuata. Kila SDK inafuata API ile ile na hali za majaribio zinazoshirikiwa.

Python

Inapatikana

Python 3.9+

pip install tmailor-sdk

Inajumuisha zana ya mstari wa amri ya tmailor.

Tazama kwenye PyPI Chanzo kwenye GitHub

Node.js

Inapatikana

Node.js 18+, TypeScript types

npm install tmailor

Tazama kwenye npm Chanzo kwenye GitHub

PHP

Inapatikana

PHP 8.1+

composer require tmailor/tmailor

Tazama kwenye Packagist Chanzo kwenye GitHub

Kwa mawakala wa AI

Seva ya MCP kwa mawakala wa AI

Ruhusu Claude, Cursor, VS Code Copilot na wateja wengine wa MCP wajaribu michakato ya kujisajili unayomiliki au unayoruhusiwa kujaribu: wakala huunda anwani halisi ya kupokea tu, husubiri barua pepe na kusoma msimbo wa mara moja au kiungo cha uthibitishaji.

Chaguo zote mbili humpa wakala zana zile zile: kuunda anwani, kusubiri barua pepe na kupata msimbo wake wa mara moja na viungo, kusoma ujumbe, kufuta anwani na kuangalia kiwango chako. Wakala huona anwani za barua pepe pekee, kamwe haoni token zilizo nyuma yao, na hutumia mgawo ule ule wa kisanduku cha barua na kikomo cha kasi kama API.

Seva inayohifadhiwa

Hakuna cha kusakinisha

https://mcp.tmailor.com/mcp

Ongeza URL ya seva kwenye programu yako ya AI. Programu zinazotumia kuingia, kama vile Claude, ChatGPT na Codex, hukupeleka kwenye jukwaa la Tmailor ili kuidhinisha ufikiaji. Programu nyingine hutuma ufunguo wako wa API kwenye kichwa cha Authorization.

Inahitaji mpango wa kulipwa unaoendelea. Maombi hutoka kwenye seva yetu, kwa hivyo huhitaji orodha ya IP zinazoruhusiwa.

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

Tazama programu zilizounganishwa kwenye ukurasa wa AI connections na ukate yoyote kati yao. Programu iliyokatwa hupoteza ufikiaji ndani ya sekunde 30.

Tazama mipango na mipaka

Seva ya ndani

Mipango yote, ikiwemo Bure

tmailor-mcp

Inaendeshwa kwenye kompyuta yako, husoma ufunguo wako kutoka TMAILOR_API_KEY na inahitaji uv au Python 3.10+. Kwenye mpango wa Bure, ongeza IP ya kompyuta hiyo kwenye orodha ya kuruhusiwa.

# 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

Tazama kwenye PyPI Usanidi kwa kila mteja wa MCP

Jaribu kuuliza: "Unda barua pepe ya muda, jisajili kwenye tovuti yangu ya majaribio kwa kuitumia na uniambie msimbo wa uthibitishaji."

Maswali Yanayoulizwa Mara kwa Mara kuhusu API ya Barua Pepe ya Muda

Ni kipi kinachohesabiwa kama kisanduku cha barua?

Kila anwani mpya unayounda hutumia kisanduku kimoja cha barua kutoka kwa idadi iliyotengwa kwa mzunguko wa sasa wa siku 30. Kuorodhesha, kusoma na kufuta hakitumii visanduku vya barua, na kufuta anwani hakurudishi kisanduku cha barua.

Je, anwani zinaisha muda wake?

Hapana. Anwani hubaki kwenye akaunti yako hadi uifute. Ujumbe ulio ndani yake huhifadhiwa kwa masaa 24.

Je, ninaweza kutuma barua pepe au kupokea viambatisho?

Hapana. API inapokea tu na viambatisho havipokelewi.

Je, ninaweza kuchagua jina la anwani na kikoa?

Kwenye vikoa vyetu vya pamoja jina huwa la nasibu. Ili kuchagua jina, ongeza na uthibitishe kikoa unachomiliki kwenye jukwaa la API kwa kuelekeza rekodi yake ya MX kwetu, kisha uunde anwani zenye jina maalum linalofuata sheria za uundaji wa majina.

Je, ninahitaji orodha ya IP zinazoruhusiwa?

Ni kwenye mpango wa Bure pekee, ambapo unaongeza anwani moja ya IP ambayo seva yako inatuma maombi kutoka kwayo. Anwani ya IP inaweza kuwa ya akaunti moja tu ya Bure, kwa hivyo anwani ya ofisi inayoshirikiwa au ya VPN inaweza kuwa tayari inatumiwa. Ukiwa na mpango wa kulipwa unaotumika, API inakubali maombi kutoka kwa anwani yoyote ya IP.

Je, API inanisomea msimbo wa uthibitishaji?

Ndio, kwa kadri inavyowezekana. Unaposoma ujumbe, jibu linajumuisha msimbo wa mara moja uliogunduliwa (au null inapokuwa haina uhakika), thamani zingine zinazofanana na msimbo na viungo. Daima hakiki thamani hiyo kwenye jaribio lako.

Je, mawakala wa AI kama Claude au ChatGPT wanaweza kutumia API?

Ndio, kupitia MCP. Kwenye mpango wa kulipwa, ongeza seva inayopangishwa https://mcp.tmailor.com/mcp kwenye programu yako ya AI na uidhinishe ufikiaji, au tuma ufunguo wako wa API. Kwenye mpango wowote, unaweza kuendesha seva ya chanzo huria tmailor-mcp kwenye kompyuta yako mwenyewe. Kwa vyovyote vile, wakala anaweza kuunda anwani, kusubiri barua pepe na kusoma msimbo wa mara moja, akitumia mgawo sawa wa visanduku vya barua kama API.

Je, kuna kikomo cha maombi kwenye mipango ya kulipwa?

Mipango ya kulipwa haina kikomo cha maombi cha kila siku au kila mwezi, lakini kila mpango una kikomo cha kasi cha kila dakika. Mpango wa Bure pia una kikomo cha maombi cha kila siku.

Je, ninahitaji kadi ya mkopo ili kuanza?

Hapana. Ingia kwa akaunti yako ya tmailor.com au Google, unda ufunguo na uanze kwenye mpango wa Bure. Unalipa tu unapochagua mpango wa kulipwa.

Ninawezaje kulipia mpango?

Lipa kwa USDT kwenye mtandao wa TRC20 (Tron) au BEP20 (BNB Smart Chain), au kwa Binance Pay. Kadi za mkopo na debit hazikubaliwi. Mpango wako huanza kutumika malipo yanapothibitishwa, kwa kawaida ndani ya dakika chache.

Je, ninaweza kurejeshewa pesa?

Hapana. Malipo hayarejeshwi, kwa hivyo jaribu ujumuishaji wako kwenye mpango wa Bure kabla ya kupandisha daraja.

API hairuhusiwi kwa matumizi gani?

Barua taka, ulaghai, kuunda akaunti kwa wingi kwenye huduma zingine, na kukwepa marufuku au vikomo vyao hukiuka masharti ya API. Tunaweza kubatilisha funguo za API za akaunti zinazofanya hivi na kuzifunga.

Unda anwani yako ya kwanza ndani ya dakika chache

Anza na mpango wa Bure ukiwa na visanduku vya barua 100 kwa mwezi. Hakuna kadi ya mkopo inayohitajika.

Anza bure Soma hati za API

API ya Barua Pepe za Muda kwa Upimaji na Uendeshaji

Lipa kwa kila sanduku la barua, si kwa kila ombi

Kutoka ufunguo wa API hadi kikasha katika hatua nne

Unda ufunguo wa API

Unda anwani

Soma ujumbe

Ihifadhi au uifute

Imeundwa kwa mtiririko wa barua pepe unaorudiwa

Majisajili na majaribio ya OTP

Mabomba ya CI/CD

QA na mazingira ya majaribio

Anwani kwenye kikoa chako mwenyewe

Mipango na bei

Bure

Starter

Pro

Business

Scale

Enterprise

Linganisha mipango

Imejumuishwa katika kila mpango

SDK rasmi na CLI

Python

Node.js

PHP

Seva ya MCP kwa mawakala wa AI

Seva inayohifadhiwa

Seva ya ndani

Maswali Yanayoulizwa Mara kwa Mara kuhusu API ya Barua Pepe ya Muda

Unda anwani yako ya kwanza ndani ya dakika chache