Tmailor Open API

API Temp Mail untuk Pengujian dan Otomatisasi

Buat alamat email sementara yang hanya menerima pesan dari kode Anda dan baca pesan masuk sebagai JSON. Setiap alamat tetap tersimpan di akun Tmailor Anda sampai Anda menghapusnya, dan API mengembalikan kode sekali pakai yang ditemukannya dalam pesan.

Terakhir diperbarui: October 2026

Mulai gratis Baca dokumentasi API

Lihat paket dan batasan

REST dan JSON
SDK, CLI, dan server MCP
100 kotak surat gratis per bulan
Hanya menerima, pesan 24 jam

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;

Buat alamat, tunggu email, baca kodenya.

Bayar per kotak surat, bukan per permintaan

Hanya pembuatan alamat yang menggunakan kuota kotak surat Anda. Menampilkan daftar alamat, memeriksa kotak masuk, serta membaca atau menghapus pesan tidak menggunakannya. Paket berbayar tidak memiliki kuota permintaan harian atau bulanan, hanya batas laju per menit.

Contoh: pengujian OTP yang membuat satu alamat dan memeriksa kotak masuk 25 kali tetap menggunakan satu kotak surat.

Dari kunci API ke kotak masuk dalam empat langkah

Buat kunci API
Masuk ke platform API dengan akun tmailor.com Anda atau akun Google, lalu buat kunci. Pada paket Free, tambahkan juga satu alamat IP server yang akan memanggil API.
Buat alamat
Kirim satu permintaan untuk mendapatkan alamat acak di domain bersama, atau pilih nama khusus pada domain milik Anda yang sudah diverifikasi.
Baca pesannya
Tampilkan daftar kotak masuk dan baca setiap pesan sebagai JSON: pengirim, subjek, teks, HTML yang sudah dibersihkan, serta kode sekali pakai dan tautan yang ditemukan API.
Simpan atau hapus
Alamat tidak kedaluwarsa. Buka kotak masuk yang sama di tmailor.com dengan tautan penggunaannya kembali, atau hapus alamat tersebut setelah pengujian selesai.

Dirancang untuk alur kerja email yang dapat diulang

Beri setiap uji coba kotak masuknya sendiri, bukan berbagi satu kotak surat asli.

Pendaftaran dan pengujian OTP

Buat alamat baru untuk setiap pendaftaran, reset kata sandi, atau pemeriksaan kode sekali pakai, lalu baca kodenya dari respons.

Pipeline CI/CD

Jalankan pemeriksaan email end-to-end di pipeline Anda dengan kunci di variabel lingkungan. Paket berbayar menerima permintaan dari alamat IP mana pun.

QA dan staging

Beri penguji dan lingkungan staging alamatnya sendiri serta jaga agar kotak masuk asli tidak masuk ke data pengujian.

Alamat di domain Anda sendiri

Tambahkan domain yang Anda miliki, arahkan catatan MX-nya ke kami, dan buat alamat dengan nama khusus yang mengikuti aturan penamaan.

Paket dan harga

Pilih jumlah kotak surat yang Anda butuhkan. Kuota Anda diperbarui setiap 30 hari, termasuk pada paket tahunan.

Gratis

Coba API dan jalankan proyek kecil.

$0 /bulan

100 kotak surat setiap 30 hari
Hingga 30 permintaan per menit
2,000 permintaan per hari
Panggilan dari satu IP yang diizinkan
Domain bersama dan domain Anda sendiri

Mulai gratis

Starter

Untuk satu pengembang atau rangkaian pengujian kecil.

$9 /bulan

3,000 kotak surat setiap 30 hari
Hingga 300 permintaan per menit
Tanpa kuota permintaan harian atau bulanan
Panggilan dari alamat IP mana pun
Domain bersama dan domain Anda sendiri

Pilih Starter

Pro

Untuk tim yang menjalankan pengujian setiap hari.

$29 /bulan

30,000 kotak surat setiap 30 hari
Hingga 600 permintaan per menit
Tanpa kuota permintaan harian atau bulanan
Panggilan dari alamat IP mana pun
Domain bersama dan domain Anda sendiri

Pilih Pro

Business

Untuk perusahaan dengan otomatisasi harian yang intensif.

$99 /bulan

150,000 kotak surat setiap 30 hari
Hingga 2,000 permintaan per menit
Tanpa kuota permintaan harian atau bulanan
Panggilan dari alamat IP mana pun
Domain bersama dan domain Anda sendiri

Pilih Business

Scale

Untuk banyak rangkaian pengujian dan pipeline yang sibuk.

$199 /bulan

400,000 kotak surat setiap 30 hari
Hingga 4,000 permintaan per menit
Tanpa kuota permintaan harian atau bulanan
Panggilan dari alamat IP mana pun
Domain bersama dan domain Anda sendiri

Pilih Scale

Enterprise

Untuk volume kotak surat dan laju permintaan tertinggi.

$499 /bulan

2,000,000 kotak surat setiap 30 hari
Hingga 6,000 permintaan per menit
Tanpa kuota permintaan harian atau bulanan
Panggilan dari alamat IP mana pun
Domain bersama dan domain Anda sendiri

Pilih Enterprise

Bandingkan paket

Batasan ini berbeda di setiap paket. Fitur lainnya sama di semua paket.

Bandingkan paket
Paket	Gratis	Starter	Pro	Business	Scale	Enterprise
Harga bulanan	$0	$9	$29	$99	$199	$499
Harga tahunan	$0	$90	$290	$990	$1,990	$4,990
Kotak surat per 30 hari	100	3,000	30,000	150,000	400,000	2,000,000
Permintaan per menit	30	300	600	2,000	4,000	6,000
Batas permintaan harian	2,000	Tanpa batas	Tanpa batas	Tanpa batas	Tanpa batas	Tanpa batas
Daftar IP yang diizinkan	Wajib, 1 IP	Tidak diperlukan	Tidak diperlukan	Tidak diperlukan	Tidak diperlukan	Tidak diperlukan
Server MCP yang dihosting	Hanya server lokal	Termasuk	Termasuk	Termasuk	Termasuk	Termasuk

Geser ke samping untuk membandingkan semua paket.

Tersedia di semua paket

API REST dengan respons JSON
Alamat acak pada domain bersama
Nama kustom pada domain terverifikasi milik Anda
Domain sendiri tanpa batas (hingga 3 domain dapat menunggu verifikasi sekaligus)
Alamat yang tidak kedaluwarsa
Tanpa batas jumlah alamat yang Anda simpan
Pesan disimpan selama 24 jam
Ekstraksi kode dan tautan sekali pakai (sebisanya)
Tautan penggunaan ulang untuk membuka kotak masuk di tmailor.com
SDK resmi dan alat baris perintah
Paket dapat digabungkan dan batasnya dijumlahkan
Hanya menerima, tanpa lampiran
Menghapus alamat tidak mengembalikan kuota

Setelah kuota kotak surat habis, alamat baru tidak dapat dibuat hingga siklus berikutnya atau hingga Anda melakukan upgrade. Kotak masuk yang sudah ada tetap berfungsi.
Pembayaran tidak dapat dikembalikan sesuai dengan ketentuan API. Uji integrasi Anda di paket Gratis terlebih dahulu.

SDK Resmi dan CLI

Panggil API dari bahasa pemrograman Anda sendiri dengan model bertipe, percobaan ulang otomatis, dan helper yang menunggu pesan berikutnya. Setiap SDK mengikuti API yang sama dan skenario pengujian yang sama.

Python

Tersedia

Python 3.9+

pip install tmailor-sdk

Termasuk tmailor command-line tool.

Lihat di PyPI Sumber di GitHub

Node.js

Tersedia

Node.js 18+, TypeScript types

npm install tmailor

Lihat di npm Sumber di GitHub

PHP

Tersedia

PHP 8.1+

composer require tmailor/tmailor

Lihat di Packagist Sumber di GitHub

Untuk agen AI

Server MCP untuk agen AI

Biarkan Claude, Cursor, VS Code Copilot, dan klien MCP lainnya menguji alur pendaftaran yang Anda miliki atau yang diizinkan untuk diuji: agen membuat alamat nyata yang hanya bisa menerima email, menunggu email masuk, lalu membaca kode sekali pakai atau tautan verifikasinya.

Kedua opsi memberi agen alat yang sama: membuat alamat, menunggu email masuk dan mendapatkan kode sekali pakai serta tautannya, membaca pesan, menghapus alamat, dan memeriksa kuota Anda. Agen hanya melihat alamat email, tidak pernah token di baliknya, dan penggunaan alat ini memakai kuota kotak surat serta batas laju yang sama dengan API.

Server terkelola

Tanpa perlu instalasi

https://mcp.tmailor.com/mcp

Tambahkan URL server ke aplikasi AI Anda. Aplikasi yang mendukung proses masuk, seperti Claude, ChatGPT, dan Codex, akan mengarahkan Anda ke platform Tmailor untuk menyetujui akses. Klien lain mengirimkan kunci API Anda di header Authorization.

Memerlukan paket berbayar yang aktif. Permintaan dikirim dari server kami, jadi Anda tidak perlu mendaftarkan IP yang diizinkan.

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

Lihat aplikasi yang terhubung di halaman AI connections dan putuskan koneksi aplikasi mana pun. Aplikasi yang diputus akan kehilangan akses dalam 30 detik.

Lihat paket dan batasan

Server lokal

Semua paket, termasuk Gratis

tmailor-mcp

Server ini berjalan di komputer Anda, membaca kunci dari TMAILOR_API_KEY, dan membutuhkan uv atau Python 3.10+. Pada paket Gratis, tambahkan alamat IP komputer tersebut ke allowlist.

# 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

Lihat di PyPI Pengaturan untuk setiap klien MCP

Coba minta: "Buat email sementara, daftar di situs staging saya dengan email itu, lalu beri tahu saya kode verifikasinya."

FAQ API email sementara

Apa yang dihitung sebagai kotak surat?

Setiap alamat baru yang Anda buat menggunakan satu kotak surat dari jatah siklus 30 hari saat ini. Menampilkan daftar, membaca, dan menghapus tidak menggunakan kotak surat, dan menghapus alamat tidak mengembalikan kotak surat tersebut.

Apakah alamatnya kedaluwarsa?

Tidak. Alamat tetap ada di akun Anda sampai Anda menghapusnya. Pesan di dalamnya disimpan selama 24 jam.

Bisakah saya mengirim email atau menerima lampiran?

Tidak. API hanya menerima email dan lampiran tidak dikirimkan.

Bisakah saya memilih nama alamat dan domain?

Di domain bersama kami, namanya acak. Untuk memilih nama, tambahkan dan verifikasi domain milik Anda di platform API dengan mengarahkan catatan MX-nya ke kami, lalu buat alamat dengan nama khusus yang mengikuti aturan penamaan.

Apakah saya perlu daftar izin IP?

Hanya pada paket Gratis, tempat Anda menambahkan satu alamat IP yang digunakan server Anda untuk melakukan panggilan. Satu alamat IP hanya dapat dimiliki oleh satu akun Gratis, jadi alamat kantor bersama atau alamat VPN mungkin sudah dipakai. Dengan paket berbayar yang aktif, API menerima permintaan dari alamat IP mana pun.

Apakah API membaca kode verifikasi untuk saya?

Ya, sejauh yang dapat dilakukan. Saat Anda membaca pesan, respons menyertakan kode sekali pakai yang ditemukan (atau null jika tidak yakin), nilai lain yang mirip kode, dan tautannya. Selalu periksa nilainya dalam pengujian Anda.

Apakah agen AI seperti Claude atau ChatGPT dapat menggunakan API?

Ya, melalui MCP. Pada paket berbayar, tambahkan server yang dihosting https://mcp.tmailor.com/mcp ke aplikasi AI Anda dan setujui aksesnya, atau kirim kunci API Anda. Pada paket apa pun, Anda dapat menjalankan server tmailor-mcp sumber terbuka di komputer Anda sendiri. Dengan cara apa pun, agen dapat membuat alamat, menunggu email, dan membaca kode sekali pakai, dengan menggunakan kuota kotak surat yang sama seperti API.

Apakah ada batas permintaan pada paket berbayar?

Paket berbayar tidak memiliki kuota permintaan harian atau bulanan, tetapi setiap paket memiliki batas laju per menit. Paket Gratis juga memiliki batas permintaan harian.

Apakah saya perlu kartu kredit untuk memulai?

Tidak. Masuk dengan akun tmailor.com Anda atau Google, buat kunci, dan mulai dengan paket Gratis. Anda hanya membayar saat memilih paket berbayar.

Bagaimana cara membayar paket?

Bayar dengan USDT di jaringan TRC20 (Tron) atau BEP20 (BNB Smart Chain), atau dengan Binance Pay. Kartu kredit dan debit tidak diterima. Paket Anda aktif setelah pembayaran dikonfirmasi, biasanya dalam beberapa menit.

Bisakah saya mendapatkan pengembalian dana?

Tidak. Pembayaran tidak dapat dikembalikan, jadi uji integrasi Anda di paket Gratis sebelum melakukan upgrade.

Untuk apa API tidak boleh digunakan?

Spam, penipuan, membuat akun secara massal di layanan lain, serta menghindari larangan atau batas mereka melanggar ketentuan API. Kami dapat mencabut kunci API akun yang melakukan hal ini dan mengunci akun tersebut.

Buat alamat pertama Anda dalam hitungan menit

Mulai dengan paket Gratis dengan 100 kotak surat per bulan. Tidak perlu kartu kredit.

Mulai gratis Baca dokumentasi API

API Temp Mail untuk Pengujian dan Otomatisasi

Bayar per kotak surat, bukan per permintaan

Dari kunci API ke kotak masuk dalam empat langkah

Buat kunci API

Buat alamat

Baca pesannya

Simpan atau hapus

Dirancang untuk alur kerja email yang dapat diulang

Pendaftaran dan pengujian OTP

Pipeline CI/CD

QA dan staging

Alamat di domain Anda sendiri

Paket dan harga

Gratis

Starter

Pro

Business

Scale

Enterprise

Bandingkan paket

Tersedia di semua paket

SDK Resmi dan CLI

Python

Node.js

PHP

Server MCP untuk agen AI

Server terkelola

Server lokal

FAQ API email sementara

Buat alamat pertama Anda dalam hitungan menit