Dokumentasi API TempMailg

REST API v1 & Webhooks

TempMailg Dokumen API Pengembang

Gunakan dokumentasi ini untuk membuat kunci API pribadi Anda, menyambungkan host API pengguna khusus, membaca pesan kotak surat, mengelola kotak surat milik Anda, dan mengintegrasikan Temp Mail ke dalam aplikasi atau otomatisasi Anda sendiri.

Otentikasi Token Bearer Webhook Waktu Nyata Alias Gmail & Outlook Respons JSON
URL Dasar API Pengguna HTTPS
Format permintaan Gunakan kunci API Anda hanya di header Authorization Bearer dan jaga kebersihan URL endpoint.

Manajemen Kotak Surat

Ambil domain yang diizinkan, buat atau ganti kotak surat, pilih masa pakai yang diizinkan, dan hapus alamat yang dimiliki.

GET https://v1.tempmailg.com/api/domains?type={type}
#

Daftar Domain yang Diizinkan

Daftar domain yang tersedia untuk membuat email sementara. Filter berdasarkan tipe untuk melihat hanya domain gratis, premium, atau khusus yang didukung oleh paket langganan Anda.

Parameter 1
Parameter Lokasi Jenis Status Deskripsi
type query string opsional
Filter tingkat domain. Penghilangan menggunakan semua ketika akses domain-premium diaktifkan, jika tidak maka gratis. Nilai yang dikenali: free, basic, pro, premium, custom, ultimate, all
Bawaan: Tergantung akun
Dapatkan domain yang diizinkan
curl --request GET \
  --url 'https://v1.tempmailg.com/api/domains?type=free' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Respons ilustratif menggunakan data sintetis. ID, alamat, token, cap waktu, batas dan hitungan paket bervariasi. Contoh masa pakai tidak menggantikan default paket Anda. Deskripsi bidang respons mengidentifikasi bidang yang dapat bernilai null dan spesifik penyedia.

Contoh respons
200 OK • JSON
{
    "status": true,
    "data": {
        "requested_type": "free",
        "plan": "pro",
        "plan_name": "Pro Plan",
        "allowed_types": [
            "free",
            "basic",
            "pro",
            "premium",
            "custom",
            "ultimate",
            "all"
        ],
        "domains": [
            {
                "domain": "example.com",
                "type": "Free",
                "custom": false
            }
        ]
    }
}
Bidang respons
Bidang Jenis Deskripsi
status boolean
Apakah operasi berhasil.
data.requested_type string
Filter domain diterapkan.
data.plan string
Tag rencana saat ini.
data.plan_name string
Nama yang dapat dibaca dari paket saat ini.
data.allowed_types array<string>
Filter domain tersedia untuk akun ini. Filter yang dikenali masih dapat dilarang untuk paket Anda.
data.domains array
Domain yang dapat dipilih setelah penyaringan; array kosong dianggap valid.
data.domains[].domain string
Nama domain yang dapat dipilih.
data.domains[].type string
Label tingkat domain yang dapat dibaca.
data.domains[].custom boolean
Apakah ini domain khusus.
POST https://v1.tempmailg.com/api/emails
#

Buat Kotak Surat Sementara

Buat kotak surat sementara yang dimiliki. Abaikan nama pengguna dan domain untuk pembuatan acak, atau berikan nama pengguna khusus yang diizinkan dan domain yang diperbolehkan. Parameter provider dapat memilih pembuatan alias Gmail atau Outlook.

Parameter 8
Parameter Lokasi Jenis Status Deskripsi
username body string opsional
Nama pengguna khusus opsional: 2 hingga 64 huruf ASCII, angka, titik, garis bawah, atau tanda hubung. Memerlukan izin paket; custom_username juga diterima.
Bawaan: Dihasilkan secara acak
domain body string opsional
Salah satu domain yang diizinkan yang dikembalikan oleh GET /domains. Penghilangan memilih domain yang diizinkan secara acak.
Bawaan: Domain yang diizinkan secara acak
lifetime body string opsional
nilai yang diizinkan:
10m — 10 Menit 1h — 1 Jam 2h — 2 Jam 1d — 1 Hari 1w — 1 Minggu 1m — 30 Hari 3m — 90 hari 6m — 180 Hari 1y — 365 Hari unlimited — Tidak Terbatas
Bawaan: Masa pakai default rencana
provider body string opsional
Penyedia kotak surat: standard, gmail_alias, atau outlook_alias.
Bawaan: standard
pin_enabled body boolean opsional
Perlindungan PIN opsional untuk kotak surat baru, bila diizinkan oleh paket Anda. Ini tidak mengubah PIN kotak surat yang sudah ada.
Bawaan: false
pin body string opsional
Diperlukan ketika pin_enabled bernilai true: PIN dengan 6 hingga 8 digit, dikirim sebagai string untuk mempertahankan nol di depan.
pin_confirmation body string opsional
Diperlukan ketika pin_enabled bernilai true. Harus persis cocok dengan pin.
Idempotency-Key header string opsional
Diperlukan untuk pembuatan atau penghapusan yang dilindungi PIN: kunci stabil 16 hingga 128 karakter. Ulangi permintaan yang sama dengan kunci yang sama untuk menghindari pekerjaan duplikat.
Parameter tubuh opsional: username (nama pengguna khusus jika diizinkan oleh paket), domain (domain yang diizinkan, mis. example.com), lifetime (nilai yang diizinkan: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited), provider (standard, gmail_alias, outlook_alias). Lewati masa pakai, atau biarkan kosong, untuk menggunakan Default Email Lifetime yang dikonfigurasi untuk paket bulanan/tahunan Anda saat ini. Kirim masa pakai yang diizinkan seperti 1h untuk mengganti default tersebut. Tidak terbatas hanya digunakan ketika dikonfigurasi sebagai default paket atau secara eksplisit diminta dan diizinkan. Parameter tubuh mailbox_lifetime dan email_lifetime juga diterima; nilai tidak kosong pertama yang menang dalam urutan ini: lifetime, mailbox_lifetime, email_lifetime. Nilai yang tidak valid atau tidak diizinkan mengembalikan HTTP 422 alih-alih secara diam-diam memilih nilai default.
Buat kotak surat
curl --request POST \
  --url 'https://v1.tempmailg.com/api/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Respons ilustratif menggunakan data sintetis. ID, alamat, token, cap waktu, batas dan hitungan paket bervariasi. Contoh masa pakai tidak menggantikan default paket Anda. Deskripsi bidang respons mengidentifikasi bidang yang dapat bernilai null dan spesifik penyedia.

Contoh respons
200 OK • JSON
{
    "status": true,
    "data": {
        "id": 2301,
        "pin_protected": false,
        "email": "demo123@example.com",
        "domain": "example.com",
        "provider": "standard",
        "expire_at": "2026-11-20T02:18:06+00:00",
        "expires_in_seconds": 86399.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:18:06+00:00",
        "email_token": "encrypted-email-token"
    }
}
Bidang respons
Bidang Jenis Deskripsi
status boolean
Apakah operasi berhasil.
data.id integer
ID Kotak Surat. ID, alamat, dan token yang dihasilkan berbeda untuk setiap kotak surat.
data.pin_protected boolean
Apakah kotak surat ini memiliki perlindungan PIN. Tidak ada PIN atau hash PIN yang dikembalikan.
data.email string
Dihasilkan alamat kotak surat lengkap.
data.domain string
Domain kotak surat yang dihasilkan.
data.provider string
Penyedia kotak surat: standard, gmail_alias, atau outlook_alias.
data.expire_at string|null
Kedaluwarsa efektif sebagai timestamp ISO-8601, atau null untuk kotak surat tak terbatas.
data.expires_in_seconds number|null
Detik yang tersisa (non-negatif) saat dihitung; detik pecahan dimungkinkan. Null berarti tidak terbatas, bukan nol.
data.mailbox_state string
Status kotak surat saat ini: aktif, dijeda, kedaluwarsa, atau tidak aktif.
data.receiving_enabled boolean
Apakah kotak surat ini saat ini menerima pesan masuk.
data.message_count integer
Jumlah total pesan yang diketahui; dapat mencerminkan sinkronisasi kotak surat terakhir.
data.unread_message_count integer
Jumlah pesan belum dibaca yang diketahui; dapat mencerminkan sinkronisasi kotak surat terakhir.
data.last_message_received_at string|null
Waktu pesan yang diterima terakhir yang diketahui dalam format ISO-8601, atau null bila tidak tersedia.
data.message_count_synced_at string|null
Waktu sinkronisasi hitungan pesan terakhir dalam format ISO-8601, atau null sebelum sinkronisasi.
data.created_at string|null
Waktu pembuatan kotak surat dalam format ISO-8601.
data.email_token string
Referensi kotak surat terenkripsi yang tidak transparan. Ini tidak menggantikan otentikasi Bearer, pemeriksaan kepemilikan, atau otorisasi PIN.
data.pin_grant object
Kondisional: pembuatan kotak surat yang dilindungi PIN aktif mengembalikan izin baca ini; pembuatan biasa yang tidak dilindungi mengabaikannya.
data.pin_grant.mailbox_id integer
ID kotak surat yang menjadi ikatan pemberian baca bersyarat.
data.pin_grant.unlock_token string
Token baca tidak transparan untuk X-Mailbox-Unlock dengan kredensial pemilik yang sama. Jaga tetap pribadi dan di memori; izin baca tidak mengizinkan penghapusan.
data.pin_grant.scope string
Cakupan dibaca untuk pemberian pembuatan bersyarat.
data.pin_grant.idle_timeout_seconds integer
Waktu menganggur yang diizinkan untuk hak baca, biasanya 3600 detik.
data.pin_grant.absolute_timeout_seconds integer
Masa hidup maksimum dari izin baca, biasanya 86400 detik.
data.pin_grant.expires_at string
Kedaluwarsa hak baca saat ini dalam format ISO-8601.
data.pin_grant.absolute_expires_at string
Kedaluwarsa hak baca absolut dalam format ISO-8601. Perubahan keamanan dapat mencabut hak tersebut lebih awal.
POST https://v1.tempmailg.com/api/emails/{email}/{username}/{domain}
#

Perbarui / Ganti Kotak Surat

Buat atau pilih kotak surat pada nama pengguna dan domain baru setelah memverifikasi kepemilikan kotak surat saat ini. Ini tidak mengganti nama kotak surat lama atau mengubah masa berlakunya secara langsung. Ketika tujuan berbeda, kotak surat lama tetap ada dalam riwayat dan dapat dihentikan oleh batas kotak surat aktif. Menggunakan kembali tujuan aktif Anda sendiri akan menerapkan kembali masa berlaku yang diminta atau default paket.

Parameter 9
Parameter Lokasi Jenis Status Deskripsi
email path string wajib
Alamat email lengkap saat ini dari kotak surat yang dimiliki untuk diganti. URL-encode setiap segmen jalur; encode tanda plus sebagai %2B.
username path string wajib
Nama pengguna baru yang diinginkan: 2 hingga 64 karakter alfanumerik; tergantung pada izin nama pengguna khusus.
domain path string wajib
Nama domain yang diizinkan baru.
lifetime body string opsional
nilai yang diizinkan:
10m — 10 Menit 1h — 1 Jam 2h — 2 Jam 1d — 1 Hari 1w — 1 Minggu 1m — 30 Hari 3m — 90 hari 6m — 180 Hari 1y — 365 Hari unlimited — Tidak Terbatas
Bawaan: Masa pakai default rencana
pin_enabled body boolean opsional
Perlindungan PIN opsional untuk kotak surat baru, bila diizinkan oleh paket Anda. Ini tidak mengubah PIN kotak surat yang sudah ada.
Bawaan: false
pin body string opsional
Diperlukan ketika pin_enabled bernilai true: PIN dengan 6 hingga 8 digit, dikirim sebagai string untuk mempertahankan nol di depan.
pin_confirmation body string opsional
Diperlukan ketika pin_enabled bernilai true. Harus persis cocok dengan pin.
Idempotency-Key header string opsional
Diperlukan untuk pembuatan atau penghapusan yang dilindungi PIN: kunci stabil 16 hingga 128 karakter. Ulangi permintaan yang sama dengan kunci yang sama untuk menghindari pekerjaan duplikat.
X-Mailbox-Unlock header string opsional
Header, hanya kotak surat yang dilindungi: gunakan unlock_token baca. Pertama POST pin dan scope=read ke URL pembuka PIN. Pertahankan otentikasi Bearer normal Anda. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Gunakan email kotak surat yang dimiliki yang ada di {email}. Parameter body opsional: lifetime (nilai yang diizinkan: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Lewati masa pakai, atau biarkan kosong, untuk menggunakan Default Email Lifetime yang dikonfigurasi untuk paket bulanan/tahunan Anda saat ini. Kirim masa pakai yang diizinkan seperti 1h untuk mengganti default tersebut. Tidak terbatas hanya digunakan ketika dikonfigurasi sebagai default paket atau secara eksplisit diminta dan diizinkan. Parameter tubuh mailbox_lifetime dan email_lifetime juga diterima; nilai tidak kosong pertama yang menang dalam urutan ini: lifetime, mailbox_lifetime, email_lifetime. Nilai yang tidak valid atau tidak diizinkan mengembalikan HTTP 422 alih-alih secara diam-diam memilih nilai default.
Perbarui kotak surat yang dimiliki
curl --request POST \
  --url 'https://v1.tempmailg.com/api/emails/current@example.com/demo123/example.com' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Respons ilustratif menggunakan data sintetis. ID, alamat, token, cap waktu, batas dan hitungan paket bervariasi. Contoh masa pakai tidak menggantikan default paket Anda. Deskripsi bidang respons mengidentifikasi bidang yang dapat bernilai null dan spesifik penyedia.

Contoh respons
200 OK • JSON
{
    "status": true,
    "data": {
        "id": 2302,
        "pin_protected": false,
        "email": "demo123@example.com",
        "domain": "example.com",
        "provider": "standard",
        "expire_at": "2026-11-19T02:28:06+00:00",
        "expires_in_seconds": 599.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:18:06+00:00",
        "email_token": "encrypted-email-token"
    }
}
Bidang respons
Bidang Jenis Deskripsi
status boolean
Apakah operasi berhasil.
data.id integer
ID Kotak Surat. ID, alamat, dan token yang dihasilkan berbeda untuk setiap kotak surat.
data.pin_protected boolean
Apakah kotak surat ini memiliki perlindungan PIN. Tidak ada PIN atau hash PIN yang dikembalikan.
data.email string
Dihasilkan alamat kotak surat lengkap.
data.domain string
Domain kotak surat yang dihasilkan.
data.provider string
Penyedia kotak surat: standard, gmail_alias, atau outlook_alias.
data.expire_at string|null
Kedaluwarsa efektif sebagai timestamp ISO-8601, atau null untuk kotak surat tak terbatas.
data.expires_in_seconds number|null
Detik yang tersisa (non-negatif) saat dihitung; detik pecahan dimungkinkan. Null berarti tidak terbatas, bukan nol.
data.mailbox_state string
Status kotak surat saat ini: aktif, dijeda, kedaluwarsa, atau tidak aktif.
data.receiving_enabled boolean
Apakah kotak surat ini saat ini menerima pesan masuk.
data.message_count integer
Jumlah total pesan yang diketahui; dapat mencerminkan sinkronisasi kotak surat terakhir.
data.unread_message_count integer
Jumlah pesan belum dibaca yang diketahui; dapat mencerminkan sinkronisasi kotak surat terakhir.
data.last_message_received_at string|null
Waktu pesan yang diterima terakhir yang diketahui dalam format ISO-8601, atau null bila tidak tersedia.
data.message_count_synced_at string|null
Waktu sinkronisasi hitungan pesan terakhir dalam format ISO-8601, atau null sebelum sinkronisasi.
data.created_at string|null
Waktu pembuatan kotak surat dalam format ISO-8601.
data.email_token string
Referensi kotak surat terenkripsi yang tidak transparan. Ini tidak menggantikan otentikasi Bearer, pemeriksaan kepemilikan, atau otorisasi PIN.
data.pin_grant object
Kondisional: pembuatan kotak surat yang dilindungi PIN aktif mengembalikan izin baca ini; pembuatan biasa yang tidak dilindungi mengabaikannya.
data.pin_grant.mailbox_id integer
ID kotak surat yang menjadi ikatan pemberian baca bersyarat.
data.pin_grant.unlock_token string
Token baca tidak transparan untuk X-Mailbox-Unlock dengan kredensial pemilik yang sama. Jaga tetap pribadi dan di memori; izin baca tidak mengizinkan penghapusan.
data.pin_grant.scope string
Cakupan dibaca untuk pemberian pembuatan bersyarat.
data.pin_grant.idle_timeout_seconds integer
Waktu menganggur yang diizinkan untuk hak baca, biasanya 3600 detik.
data.pin_grant.absolute_timeout_seconds integer
Masa hidup maksimum dari izin baca, biasanya 86400 detik.
data.pin_grant.expires_at string
Kedaluwarsa hak baca saat ini dalam format ISO-8601.
data.pin_grant.absolute_expires_at string
Kedaluwarsa hak baca absolut dalam format ISO-8601. Perubahan keamanan dapat mencabut hak tersebut lebih awal.
DELETE https://v1.tempmailg.com/api/emails/{email}
#

Hapus Kotak Surat

Hapus kotak surat yang dimiliki dan jalankan pembersihan pesan serta file-nya. Catatan kotak surat yang dipertahankan dapat dihapus secara lunak secara internal; alamat tidak lagi dapat digunakan melalui API.

Parameter 3
Parameter Lokasi Jenis Status Deskripsi
email path string wajib
Alamat email lengkap dari kotak surat yang dimiliki untuk dihapus. URL-encode alamat tersebut; encode tanda plus sebagai %2B.
X-Mailbox-Unlock header string opsional
Header, hanya kotak surat yang dilindungi: gunakan unlock_token hapus satu kali pakai. Pertama POST pin, scope=delete dan action/target_id yang dikembalikan oleh respons 423 ke URL buka kunci PIN. Token baca tidak dapat menghapus. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Idempotency-Key header string opsional
Diperlukan untuk pembuatan atau penghapusan yang dilindungi PIN: kunci stabil 16 hingga 128 karakter. Ulangi permintaan yang sama dengan kunci yang sama untuk menghindari pekerjaan duplikat.
Hapus kotak surat yang dimiliki
curl --request DELETE \
  --url 'https://v1.tempmailg.com/api/emails/demo123@example.com' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Respons ilustratif menggunakan data sintetis. ID, alamat, token, cap waktu, batas dan hitungan paket bervariasi. Contoh masa pakai tidak menggantikan default paket Anda. Deskripsi bidang respons mengidentifikasi bidang yang dapat bernilai null dan spesifik penyedia.

Contoh respons
200 OK • JSON
{
    "status": true,
    "message": "Email has been successfully deleted."
}
Bidang respons
Bidang Jenis Deskripsi
status boolean
Apakah operasi berhasil.
message string
Hasil penghapusan. Sumber daya yang tidak ada mengembalikan HTTP 404.

Alias Gmail & Outlook

Buat kotak surat alias Gmail dan Outlook/Hotmail dengan reputasi tinggi.

POST https://v1.tempmailg.com/api/gmail-alias/emails
#

Buat Alias Gmail

Buat kotak surat sementara alias Gmail baru yang dimiliki oleh pengguna yang terautentikasi.

Parameter 8
Parameter Lokasi Jenis Status Deskripsi
mode body string opsional
Mode generasi: auto, dot, plus, atau plus_dot. Juga menerima gmail_alias_mode. Jika pemilihan gaya tidak diizinkan, auto digunakan.
Bawaan: auto
username body string opsional
Akhiran alias khusus opsional: 2 hingga 32 huruf atau digit ASCII, dinormalisasi menjadi huruf kecil; tergantung pada izin fitur. Juga menerima custom_username atau alias_username.
Bawaan: Dibuat secara otomatis
domain body string opsional
Gunakan acak, gmail.com atau googlemail.com; alias_domain juga diterima. Penghilangan atau izin pemilihan domain yang tidak tersedia menggunakan acak.
Bawaan: random
lifetime body string opsional
nilai yang diizinkan:
10m — 10 Menit 1h — 1 Jam 2h — 2 Jam 1d — 1 Hari 1w — 1 Minggu 1m — 30 Hari 3m — 90 hari 6m — 180 Hari 1y — 365 Hari unlimited — Tidak Terbatas
Bawaan: Masa pakai default rencana
pin_enabled body boolean opsional
Perlindungan PIN opsional untuk kotak surat baru, bila diizinkan oleh paket Anda. Ini tidak mengubah PIN kotak surat yang sudah ada.
Bawaan: false
pin body string opsional
Diperlukan ketika pin_enabled bernilai true: PIN dengan 6 hingga 8 digit, dikirim sebagai string untuk mempertahankan nol di depan.
pin_confirmation body string opsional
Diperlukan ketika pin_enabled bernilai true. Harus persis cocok dengan pin.
Idempotency-Key header string opsional
Diperlukan untuk pembuatan atau penghapusan yang dilindungi PIN: kunci stabil 16 hingga 128 karakter. Ulangi permintaan yang sama dengan kunci yang sama untuk menghindari pekerjaan duplikat.
Membutuhkan izin Gmail Alias API untuk diaktifkan pada paket langganan Anda atau dibuka melalui paket Kredit API. Parameter opsional: mode (auto, dot, plus, plus_dot), username (nama pengguna alias khusus), domain (misalnya gmail.com, googlemail.com), lifetime (nilai yang diizinkan: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Lewati masa pakai, atau biarkan kosong, untuk menggunakan Default Email Lifetime yang dikonfigurasi untuk paket bulanan/tahunan Anda saat ini. Kirim masa pakai yang diizinkan seperti 1h untuk mengganti default tersebut. Tidak terbatas hanya digunakan ketika dikonfigurasi sebagai default paket atau secara eksplisit diminta dan diizinkan. Parameter tubuh mailbox_lifetime dan email_lifetime juga diterima; nilai tidak kosong pertama yang menang dalam urutan ini: lifetime, mailbox_lifetime, email_lifetime. Nilai yang tidak valid atau tidak diizinkan mengembalikan HTTP 422 alih-alih secara diam-diam memilih nilai default.
Buat kotak surat alias Gmail
curl --request POST \
  --url 'https://v1.tempmailg.com/api/gmail-alias/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Respons ilustratif menggunakan data sintetis. ID, alamat, token, cap waktu, batas dan hitungan paket bervariasi. Contoh masa pakai tidak menggantikan default paket Anda. Deskripsi bidang respons mengidentifikasi bidang yang dapat bernilai null dan spesifik penyedia.

Contoh respons
200 OK • JSON
{
    "status": true,
    "data": {
        "id": 2305,
        "pin_protected": false,
        "email": "example+alias123@gmail.com",
        "domain": "gmail.com",
        "provider": "gmail_alias",
        "expire_at": "2026-11-19T03:18:06+00:00",
        "expires_in_seconds": 3599.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:18:06+00:00",
        "email_token": "encrypted-email-token"
    }
}
Bidang respons
Bidang Jenis Deskripsi
status boolean
Apakah operasi berhasil.
data.id integer
ID Kotak Surat. ID, alamat, dan token yang dihasilkan berbeda untuk setiap kotak surat.
data.pin_protected boolean
Apakah kotak surat ini memiliki perlindungan PIN. Tidak ada PIN atau hash PIN yang dikembalikan.
data.email string
Dihasilkan alamat kotak surat lengkap.
data.domain string
Domain kotak surat yang dihasilkan.
data.provider string
Penyedia kotak surat: standard, gmail_alias, atau outlook_alias.
data.expire_at string|null
Kedaluwarsa efektif sebagai timestamp ISO-8601, atau null untuk kotak surat tak terbatas.
data.expires_in_seconds number|null
Detik yang tersisa (non-negatif) saat dihitung; detik pecahan dimungkinkan. Null berarti tidak terbatas, bukan nol.
data.mailbox_state string
Status kotak surat saat ini: aktif, dijeda, kedaluwarsa, atau tidak aktif.
data.receiving_enabled boolean
Apakah kotak surat ini saat ini menerima pesan masuk.
data.message_count integer
Jumlah total pesan yang diketahui; dapat mencerminkan sinkronisasi kotak surat terakhir.
data.unread_message_count integer
Jumlah pesan belum dibaca yang diketahui; dapat mencerminkan sinkronisasi kotak surat terakhir.
data.last_message_received_at string|null
Waktu pesan yang diterima terakhir yang diketahui dalam format ISO-8601, atau null bila tidak tersedia.
data.message_count_synced_at string|null
Waktu sinkronisasi hitungan pesan terakhir dalam format ISO-8601, atau null sebelum sinkronisasi.
data.created_at string|null
Waktu pembuatan kotak surat dalam format ISO-8601.
data.email_token string
Referensi kotak surat terenkripsi yang tidak transparan. Ini tidak menggantikan otentikasi Bearer, pemeriksaan kepemilikan, atau otorisasi PIN.
data.pin_grant object
Kondisional: pembuatan kotak surat yang dilindungi PIN aktif mengembalikan izin baca ini; pembuatan biasa yang tidak dilindungi mengabaikannya.
data.pin_grant.mailbox_id integer
ID kotak surat yang menjadi ikatan pemberian baca bersyarat.
data.pin_grant.unlock_token string
Token baca tidak transparan untuk X-Mailbox-Unlock dengan kredensial pemilik yang sama. Jaga tetap pribadi dan di memori; izin baca tidak mengizinkan penghapusan.
data.pin_grant.scope string
Cakupan dibaca untuk pemberian pembuatan bersyarat.
data.pin_grant.idle_timeout_seconds integer
Waktu menganggur yang diizinkan untuk hak baca, biasanya 3600 detik.
data.pin_grant.absolute_timeout_seconds integer
Masa hidup maksimum dari izin baca, biasanya 86400 detik.
data.pin_grant.expires_at string
Kedaluwarsa hak baca saat ini dalam format ISO-8601.
data.pin_grant.absolute_expires_at string
Kedaluwarsa hak baca absolut dalam format ISO-8601. Perubahan keamanan dapat mencabut hak tersebut lebih awal.
GET https://v1.tempmailg.com/api/outlook-alias/domains
#

Domain Alias Outlook

Ambil domain alias Outlook / Hotmail aktif yang tersedia untuk pembuatan kotak surat.

Membutuhkan izin Outlook Alias API diaktifkan pada paket langganan Anda atau dibuka melalui paket Kredit API. Menunjukkan apakah pemilihan domain tertentu dibuka pada paket Anda.
Dapatkan domain alias Outlook
curl --request GET \
  --url 'https://v1.tempmailg.com/api/outlook-alias/domains' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Respons ilustratif menggunakan data sintetis. ID, alamat, token, cap waktu, batas dan hitungan paket bervariasi. Contoh masa pakai tidak menggantikan default paket Anda. Deskripsi bidang respons mengidentifikasi bidang yang dapat bernilai null dan spesifik penyedia.

Contoh respons
200 OK • JSON
{
    "status": true,
    "data": {
        "domains": [
            {
                "domain": "outlook.com",
                "type": "Outlook/Hotmail",
                "selectable": true,
                "locked": false,
                "disabled_reason": null
            },
            {
                "domain": "hotmail.com",
                "type": "Outlook/Hotmail",
                "selectable": true,
                "locked": false,
                "disabled_reason": null
            }
        ]
    }
}
Bidang respons
Bidang Jenis Deskripsi
status boolean
Apakah operasi berhasil.
data.domains array
Domain Outlook/Hotmail yang aktif; array kosong dianggap valid.
data.domains[].domain string
Nama domain yang tersedia.
data.domains[].type string
Label penyedia yang dapat dibaca.
data.domains[].selectable boolean
Apakah akun Anda dapat secara eksplisit memilih domain ini.
data.domains[].locked boolean
Apakah pemilihan domain eksplisit terkunci untuk akun Anda.
data.domains[].disabled_reason string|null
Alasan pemilihan domain terkunci, atau null ketika dapat dipilih.
POST https://v1.tempmailg.com/api/outlook-alias/emails
#

Buat Alias Outlook

Buat kotak surat alias Outlook / Hotmail sementara baru yang dimiliki oleh pengguna yang terautentikasi.

Parameter 7
Parameter Lokasi Jenis Status Deskripsi
domain body string opsional
Gunakan acak atau domain dari GET /outlook-alias/domains; outlook_alias_domain juga diterima. Tanpa izin pemilihan, acak akan digunakan.
Bawaan: Domain tersedia acak
username body string opsional
Akhiran alias khusus opsional: 2 hingga 32 huruf atau digit ASCII, dinormalisasi menjadi huruf kecil; tergantung pada izin fitur. Juga menerima custom_username atau alias_username.
Bawaan: Dibuat secara otomatis
lifetime body string opsional
nilai yang diizinkan:
10m — 10 Menit 1h — 1 Jam 2h — 2 Jam 1d — 1 Hari 1w — 1 Minggu 1m — 30 Hari 3m — 90 hari 6m — 180 Hari 1y — 365 Hari unlimited — Tidak Terbatas
Bawaan: Masa pakai default rencana
pin_enabled body boolean opsional
Perlindungan PIN opsional untuk kotak surat baru, bila diizinkan oleh paket Anda. Ini tidak mengubah PIN kotak surat yang sudah ada.
Bawaan: false
pin body string opsional
Diperlukan ketika pin_enabled bernilai true: PIN dengan 6 hingga 8 digit, dikirim sebagai string untuk mempertahankan nol di depan.
pin_confirmation body string opsional
Diperlukan ketika pin_enabled bernilai true. Harus persis cocok dengan pin.
Idempotency-Key header string opsional
Diperlukan untuk pembuatan atau penghapusan yang dilindungi PIN: kunci stabil 16 hingga 128 karakter. Ulangi permintaan yang sama dengan kunci yang sama untuk menghindari pekerjaan duplikat.
Membutuhkan izin Outlook Alias API diaktifkan pada paket langganan Anda atau dibuka melalui paket Kredit API. Parameter opsional: domain (mis. outlook.com, hotmail.com), username (nama pengguna alias khusus), lifetime (nilai yang diizinkan: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Lewati masa pakai, atau biarkan kosong, untuk menggunakan Default Email Lifetime yang dikonfigurasi untuk paket bulanan/tahunan Anda saat ini. Kirim masa pakai yang diizinkan seperti 1h untuk mengganti default tersebut. Tidak terbatas hanya digunakan ketika dikonfigurasi sebagai default paket atau secara eksplisit diminta dan diizinkan. Parameter tubuh mailbox_lifetime dan email_lifetime juga diterima; nilai tidak kosong pertama yang menang dalam urutan ini: lifetime, mailbox_lifetime, email_lifetime. Nilai yang tidak valid atau tidak diizinkan mengembalikan HTTP 422 alih-alih secara diam-diam memilih nilai default.
Buat kotak surat alias Outlook
curl --request POST \
  --url 'https://v1.tempmailg.com/api/outlook-alias/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Respons ilustratif menggunakan data sintetis. ID, alamat, token, cap waktu, batas dan hitungan paket bervariasi. Contoh masa pakai tidak menggantikan default paket Anda. Deskripsi bidang respons mengidentifikasi bidang yang dapat bernilai null dan spesifik penyedia.

Contoh respons
200 OK • JSON
{
    "status": true,
    "data": {
        "id": 2306,
        "pin_protected": false,
        "email": "example+alias45@outlook.com",
        "domain": "outlook.com",
        "provider": "outlook_alias",
        "expire_at": "2026-11-19T03:18:06+00:00",
        "expires_in_seconds": 3599.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:18:06+00:00",
        "email_token": "encrypted-email-token"
    }
}
Bidang respons
Bidang Jenis Deskripsi
status boolean
Apakah operasi berhasil.
data.id integer
ID Kotak Surat. ID, alamat, dan token yang dihasilkan berbeda untuk setiap kotak surat.
data.pin_protected boolean
Apakah kotak surat ini memiliki perlindungan PIN. Tidak ada PIN atau hash PIN yang dikembalikan.
data.email string
Dihasilkan alamat kotak surat lengkap.
data.domain string
Domain kotak surat yang dihasilkan.
data.provider string
Penyedia kotak surat: standard, gmail_alias, atau outlook_alias.
data.expire_at string|null
Kedaluwarsa efektif sebagai timestamp ISO-8601, atau null untuk kotak surat tak terbatas.
data.expires_in_seconds number|null
Detik yang tersisa (non-negatif) saat dihitung; detik pecahan dimungkinkan. Null berarti tidak terbatas, bukan nol.
data.mailbox_state string
Status kotak surat saat ini: aktif, dijeda, kedaluwarsa, atau tidak aktif.
data.receiving_enabled boolean
Apakah kotak surat ini saat ini menerima pesan masuk.
data.message_count integer
Jumlah total pesan yang diketahui; dapat mencerminkan sinkronisasi kotak surat terakhir.
data.unread_message_count integer
Jumlah pesan belum dibaca yang diketahui; dapat mencerminkan sinkronisasi kotak surat terakhir.
data.last_message_received_at string|null
Waktu pesan yang diterima terakhir yang diketahui dalam format ISO-8601, atau null bila tidak tersedia.
data.message_count_synced_at string|null
Waktu sinkronisasi hitungan pesan terakhir dalam format ISO-8601, atau null sebelum sinkronisasi.
data.created_at string|null
Waktu pembuatan kotak surat dalam format ISO-8601.
data.email_token string
Referensi kotak surat terenkripsi yang tidak transparan. Ini tidak menggantikan otentikasi Bearer, pemeriksaan kepemilikan, atau otorisasi PIN.
data.pin_grant object
Kondisional: pembuatan kotak surat yang dilindungi PIN aktif mengembalikan izin baca ini; pembuatan biasa yang tidak dilindungi mengabaikannya.
data.pin_grant.mailbox_id integer
ID kotak surat yang menjadi ikatan pemberian baca bersyarat.
data.pin_grant.unlock_token string
Token baca tidak transparan untuk X-Mailbox-Unlock dengan kredensial pemilik yang sama. Jaga tetap pribadi dan di memori; izin baca tidak mengizinkan penghapusan.
data.pin_grant.scope string
Cakupan dibaca untuk pemberian pembuatan bersyarat.
data.pin_grant.idle_timeout_seconds integer
Waktu menganggur yang diizinkan untuk hak baca, biasanya 3600 detik.
data.pin_grant.absolute_timeout_seconds integer
Masa hidup maksimum dari izin baca, biasanya 86400 detik.
data.pin_grant.expires_at string
Kedaluwarsa hak baca saat ini dalam format ISO-8601.
data.pin_grant.absolute_expires_at string
Kedaluwarsa hak baca absolut dalam format ISO-8601. Perubahan keamanan dapat mencabut hak tersebut lebih awal.

Pesan & Lampiran

Ambil kotak masuk yang masuk, baca pesan HTML/teks secara lengkap, dan alirkan lampiran.

GET https://v1.tempmailg.com/api/messages?email={email}
#

Daftar Pesan Kotak Surat

Ambil ringkasan pesan yang tersedia dan metadata kotak surat. Pemindaian kotak masuk standar mengembalikan batch terbaru hingga 25 pesan; ini bukan endpoint riwayat penuh yang dipaginasi. Gunakan GET /messages/{messageId} untuk isi lengkap dan lampiran.

Parameter 2
Parameter Lokasi Jenis Status Deskripsi
email query string wajib
Alamat email lengkap dari kotak surat yang dimiliki untuk membaca pesan. URL-encode nilai kueri; encode tanda plus sebagai %2B.
X-Mailbox-Unlock header string opsional
Header, hanya kotak surat yang dilindungi: gunakan unlock_token baca. Pertama POST pin dan scope=read ke URL pembuka PIN. Pertahankan otentikasi Bearer normal Anda. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Email harus milik akun Anda. Ringkasan standar dan Gmail berisi bidang OTP dan verification-link; Outlook juga mencakup from_name, snippet, received_at, dan has_attachments. Sinkronisasi penyedia dan caching dapat menunda pesan baru dan hitungan.
Baca pesan kotak surat
curl --request GET \
  --url 'https://v1.tempmailg.com/api/messages?email=demo123@example.com' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Respons ilustratif menggunakan data sintetis. ID, alamat, token, cap waktu, batas dan hitungan paket bervariasi. Contoh masa pakai tidak menggantikan default paket Anda. Deskripsi bidang respons mengidentifikasi bidang yang dapat bernilai null dan spesifik penyedia.

Contoh respons
200 OK • JSON
{
    "status": true,
    "mailbox": "demo123@example.com",
    "email_token": "encrypted-email-token",
    "messages": [
        {
            "is_seen": false,
            "subject": "Welcome to Temp Mail",
            "from": "Example Sender",
            "from_email": "hello@example.org",
            "receivedAt": "2026-11-19 02:18:06",
            "id": "ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1",
            "otp": null,
            "otp_locked": false,
            "verification_link": null,
            "verification_link_locked": false
        }
    ],
    "mailbox_provider": "standard",
    "mailbox_state": "active",
    "expire_at": "2026-11-20T02:18:06+00:00",
    "expires_in_seconds": 86399.75,
    "receiving_enabled": true,
    "mailbox_limit": {
        "limit": 50,
        "limit_label": "50",
        "active_count": 1,
        "paused_count": 0,
        "paused_mailboxes": [],
        "remaining": 49,
        "remaining_label": "49",
        "reached": false,
        "blocked": false,
        "provider": "standard"
    },
    "message_count": 1,
    "unread_message_count": 1,
    "last_message_received_at": "2026-11-19T02:18:06+00:00",
    "message_count_synced_at": "2026-11-19T02:18:06+00:00"
}
Bidang respons
Bidang Jenis Deskripsi
status boolean
Apakah operasi berhasil.
mailbox string
Alamat kotak surat yang pesan-pesannya diminta.
email_token string
Referensi kotak surat terenkripsi yang tidak dapat dibaca; otentikasi normal masih diperlukan.
mailbox_provider string
Penyedia kotak surat: standard, gmail_alias, atau outlook_alias.
messages array
Ringkasan pesan. Kotak masuk kosong mengembalikan array kosong; ambil satu pesan untuk isi dan lampirannya.
expire_at string|null
Kedaluwarsa efektif sebagai timestamp ISO-8601, atau null untuk kotak surat tak terbatas.
expires_in_seconds number|null
Detik yang tersisa (non-negatif) saat dihitung; detik pecahan dimungkinkan. Null berarti tidak terbatas, bukan nol.
mailbox_state string
Status kotak surat saat ini: aktif, dijeda, kedaluwarsa, atau tidak aktif.
receiving_enabled boolean
Apakah kotak surat ini saat ini menerima pesan masuk.
message_count integer
Jumlah total pesan yang diketahui; dapat mencerminkan sinkronisasi kotak surat terakhir.
unread_message_count integer
Jumlah pesan belum dibaca yang diketahui; dapat mencerminkan sinkronisasi kotak surat terakhir.
last_message_received_at string|null
Waktu pesan yang diterima terakhir yang diketahui dalam format ISO-8601, atau null bila tidak tersedia.
message_count_synced_at string|null
Waktu sinkronisasi hitungan pesan terakhir dalam format ISO-8601, atau null sebelum sinkronisasi.
mailbox_limit.limit integer
Batas kotak surat aktif untuk penyedia ini; -1 berarti tidak terbatas.
mailbox_limit.limit_label string
Label tampilan untuk batas kotak surat.
mailbox_limit.active_count integer
Jumlah kotak surat aktif untuk penyedia ini.
mailbox_limit.paused_count integer
Jumlah kotak surat yang dijeda untuk penyedia ini.
mailbox_limit.paused_mailboxes array<string>
Alamat dijeda karena batas kotak surat.
mailbox_limit.remaining integer
Slot kotak surat aktif yang tersisa; -1 berarti tidak terbatas. Ini bukan kuota permintaan API.
mailbox_limit.remaining_label string
Tampilkan label untuk slot kotak surat yang tersisa.
mailbox_limit.reached boolean
Apakah batas kotak surat aktif telah tercapai.
mailbox_limit.blocked boolean
Apakah batas kotak surat aktif adalah nol.
mailbox_limit.provider string|null
Penyedia yang batas kotak suratnya berlaku.
messages[].id string
ID pesan opak yang digunakan oleh endpoint satu-pesan, penghapusan, dan lampiran.
messages[].is_seen boolean
Apakah pesan ditandai sebagai sudah dibaca.
messages[].subject string
Subjek pesan.
messages[].from string
Nama tampilan atau alamat pengirim.
messages[].from_email string
Alamat email pengirim.
messages[].receivedAt string
Waktu diterima dalam zona waktu aplikasi, diformat sebagai YYYY-MM-DD HH:mm:ss.
messages[].otp string|null
Mendeteksi kode satu kali ketika tersedia dan diizinkan; jika tidak, null.
messages[].otp_locked boolean
Apakah kode satu kali yang terdeteksi disembunyikan oleh izin fitur.
messages[].verification_link string|null
URL verifikasi terdeteksi bila tersedia dan diizinkan; jika tidak, null.
messages[].verification_link_locked boolean
Apakah tautan verifikasi yang terdeteksi disembunyikan oleh izin fitur.
messages[].from_name string|null
Bidang ringkasan Outlook: nama pengirim asli. Tidak ada dalam ringkasan Standar dan Gmail.
messages[].snippet string|null
Bidang ringkasan Outlook: pratinjau pesan singkat.
messages[].received_at string|null
Bidang ringkasan Outlook: waktu diterima ISO-8601, bila diketahui.
messages[].has_attachments boolean
Bidang ringkasan Outlook: apakah metadata lampiran ada. Ketersediaan unduhan diperiksa secara terpisah.
GET https://v1.tempmailg.com/api/messages/{messageId}
#

Dapatkan Pesan Tunggal

Ambil pesan yang dimiliki berdasarkan ID pesan yang tidak dapat dilihat. Mengembalikan format badan dan metadata lampiran. Bidang badan tergantung pada format pesan; Outlook menambahkan bidang khusus penyedia yang tercantum di bawah.

Parameter 2
Parameter Lokasi Jenis Status Deskripsi
messageId path string wajib
ID pesan unik yang dikembalikan dalam daftar pesan.
X-Mailbox-Unlock header string opsional
Header, hanya kotak surat yang dilindungi: gunakan unlock_token baca. Pertama POST pin dan scope=read ke URL pembuka PIN. Pertahankan otentikasi Bearer normal Anda. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Baca satu pesan
curl --request GET \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Respons ilustratif menggunakan data sintetis. ID, alamat, token, cap waktu, batas dan hitungan paket bervariasi. Contoh masa pakai tidak menggantikan default paket Anda. Deskripsi bidang respons mengidentifikasi bidang yang dapat bernilai null dan spesifik penyedia.

Contoh respons
200 OK • JSON
{
    "status": true,
    "data": {
        "is_seen": true,
        "subject": "Welcome to Temp Mail",
        "from": "Example Sender",
        "from_email": "hello@example.org",
        "to": "demo123@example.com",
        "mailbox_provider": "standard",
        "receivedAt": "2026-11-19 02:18:06",
        "id": "ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1",
        "html": true,
        "html_content": "<p>Hello from the inbox.</p>",
        "text_content": "<pre>Hello from the inbox.</pre>",
        "content": "<p>Hello from the inbox.</p>",
        "attachments": [
            {
                "name": "file.txt",
                "extension": "txt",
                "size": 91,
                "url": "https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt"
            }
        ]
    }
}
Bidang respons
Bidang Jenis Deskripsi
status boolean
Apakah operasi berhasil.
data.id string
ID pesan opak.
data.is_seen boolean
Status baca pesan. Membaca dapat menandainya sebagai terlihat; data cache dapat mencerminkan status sebelumnya.
data.subject string
Subjek pesan.
data.from string
Nama tampilan atau alamat pengirim.
data.from_email string
Alamat email pengirim.
data.to string
Alamat kotak surat penerima.
data.mailbox_provider string
Penyedia kotak surat: standard, gmail_alias, atau outlook_alias.
data.receivedAt string
Waktu diterima dalam zona waktu aplikasi, diformat sebagai YYYY-MM-DD HH:mm:ss.
data.html boolean
Apakah pesan memiliki badan HTML.
data.html_content string
Badan HTML bila ada. Pesan standar tanpa HTML dapat mengabaikan bidang ini. Anggap konten pesan tidak tepercaya.
data.text_content string
Isi teks ketika ada; Pesan standar dapat berisi teks yang di-escape dalam elemen pre atau menghilangkan bidang ini.
data.content string
Badan utama untuk ditampilkan, biasanya HTML bila tersedia.
data.attachments array
Metadata lampiran, atau array kosong. Unduhan memerlukan otentikasi normal dan otorisasi PIN yang berlaku.
data.attachments[].name string
Nama file untuk di-URL-encode sebagai satu segmen jalur saat mengunduh.
data.attachments[].size integer
Ukuran lampiran dalam byte.
data.attachments[].url string
URL unduhan API Pengguna Terautentikasi ditambahkan ke lampiran dengan nama file. URL tidak menjamin bahwa file lokal tersedia.
data.attachments[].extension string
Bidang metadata Standar/Gmail: ekstensi file bila disediakan.
data.attachments[].id string
Bidang metadata Outlook: ID lampiran penyedia.
data.attachments[].content_type string
Bidang metadata Outlook: tipe konten MIME.
data.from_name string|null
Bidang detail Outlook: nama pengirim asli.
data.to_email string|null
Bidang detail Outlook: alamat penerima asli.
data.received_at string|null
Bidang detail Outlook: waktu diterima ISO-8601.
data.has_html boolean
Bidang detail Outlook: apakah ada badan HTML.
DELETE https://v1.tempmailg.com/api/messages/{messageId}
#

Hapus Pesan

Hapus satu pesan yang dimiliki.

Parameter 3
Parameter Lokasi Jenis Status Deskripsi
messageId path string wajib
String ID pesan unik untuk dihapus secara permanen.
X-Mailbox-Unlock header string opsional
Header, hanya kotak surat yang dilindungi: gunakan unlock_token hapus satu kali pakai. Pertama POST pin, scope=delete dan action/target_id yang dikembalikan oleh respons 423 ke URL buka kunci PIN. Token baca tidak dapat menghapus. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Idempotency-Key header string opsional
Diperlukan untuk pembuatan atau penghapusan yang dilindungi PIN: kunci stabil 16 hingga 128 karakter. Ulangi permintaan yang sama dengan kunci yang sama untuk menghindari pekerjaan duplikat.
Hapus satu pesan
curl --request DELETE \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Respons ilustratif menggunakan data sintetis. ID, alamat, token, cap waktu, batas dan hitungan paket bervariasi. Contoh masa pakai tidak menggantikan default paket Anda. Deskripsi bidang respons mengidentifikasi bidang yang dapat bernilai null dan spesifik penyedia.

Contoh respons
200 OK • JSON
{
    "status": true,
    "message": "Message was deleted successfully."
}
Bidang respons
Bidang Jenis Deskripsi
status boolean
Apakah operasi berhasil.
message string
Hasil penghapusan. Sumber daya yang tidak ada mengembalikan HTTP 404.
GET https://v1.tempmailg.com/api/messages/{messageId}/attachments/{filename}
#

Unduh Lampiran

Unduh lampiran dari pesan milik Anda.

Parameter 3
Parameter Lokasi Jenis Status Deskripsi
messageId path string wajib
ID pesan yang berisi file.
filename path string wajib
Nama file dan ekstensi lampiran yang akan diunduh.
X-Mailbox-Unlock header string opsional
Header, hanya kotak surat yang dilindungi: gunakan unlock_token baca. Pertama POST pin dan scope=read ke URL pembuka PIN. Pertahankan otentikasi Bearer normal Anda. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Berhasil mengembalikan byte file, bukan JSON. File yang terlalu besar mengembalikan HTTP 403; file lokal yang hilang atau tidak tersedia mengembalikan HTTP 404. URL-encode nama file sebagai satu segmen jalur. Metadata lampiran saja tidak menjamin ketersediaan unduhan.
Unduh lampiran
curl --request GET \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY' \
  --output file.txt
Perilaku unduhan Titik akhir ini mengembalikan file yang diminta secara langsung alih-alih badan JSON.
Bidang respons
Bidang Jenis Deskripsi
Content-Disposition header
Respons berhasil mengunduh nama file yang diminta.
body binary
Byte file pada keberhasilan, bukan JSON. Kesalahan mengembalikan JSON dengan status non-2xx.

Batas Laju & Kuota

Pantau anggaran permintaan waktu nyata, batas kecepatan, dan kuota akun tanpa mengonsumsi kredit.

GET https://v1.tempmailg.com/api/rate-limit
#

Batas Kecepatan & Kuota

Periksa batas kecepatan dan status kuota Anda saat ini tanpa mengonsumsi penggunaan API apa pun. Endpoint ini bebas kuota dan tidak mengurangi kredit API bulanan (batas perlindungan penyalahgunaan: 60 permintaan/menit).

X-RateLimit-* menggambarkan anggaran permintaan yang ditunjukkan; X-Quota-* menggambarkan kapasitas bulanan dan yang dibeli bila tersedia. X-Mailbox-RateLimit-* melaporkan anggaran pembuatan/pembaruan kotak surat terpisah. Penolakan hanya kotak surat menggunakan ruang lingkup kotak surat dan jendela percobaan ulangnya sendiri. Penolakan batas menit dapat mengabaikan informasi kuota. Retry-After hanya disertakan untuk percobaan ulang berwaktu; akses yang dinonaktifkan mungkin memerlukan perubahan akun. Dalam respons status yang berhasil ini, data.limit, data.remaining, dan data.reset menggambarkan anggaran menit akun, bukan kredit yang dapat dibelanjakan. Objek data.quota menggambarkan tunjangan bulanan, saldo kredit, dan penggunaan. Kolom data.monthly_limit, data.monthly_remaining, dan data.purchased_credits yang ada tetap menjadi alias dari kolom kuota yang bersesuaian. Pemeriksaan status yang berhasil tidak memberi wewenang untuk operasi API lain. Operasi tetap memerlukan akses yang diaktifkan, kuota yang tersedia, dan penerimaan melalui semua batas yang berlaku. Snapshot kuota tidak menjanjikan kapasitas yang sudah dipesan oleh permintaan yang sedang diproses.
Periksa status batas tarif
curl --request GET \
  --url 'https://v1.tempmailg.com/api/rate-limit' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Respons ilustratif menggunakan data sintetis. ID, alamat, token, cap waktu, batas dan hitungan paket bervariasi. Contoh masa pakai tidak menggantikan default paket Anda. Deskripsi bidang respons mengidentifikasi bidang yang dapat bernilai null dan spesifik penyedia.

Contoh respons
200 OK • JSON
{
    "status": "success",
    "data": {
        "limit": 60,
        "remaining": 45,
        "reset": 32,
        "plan": "premium",
        "monthly_limit": 50000,
        "monthly_remaining": 48210,
        "purchased_credits": 5000,
        "quota": {
            "enabled": true,
            "user_api_status": true,
            "plan_name": "Premium Plan",
            "period": "2026-10",
            "base_limit": 50000,
            "extra_requests": 0,
            "monthly_limit": 50000,
            "monthly_remaining": 48210,
            "used": 1790,
            "purchased_credits": 5000,
            "bonus_credits": 1000,
            "direct_purchased_credits": 4000,
            "remaining": 53210,
            "unlimited": false,
            "usage_percent": 3,
            "reset_at": "2026-11-01T00:00:00+00:00"
        }
    }
}
Bidang respons
Bidang Jenis Deskripsi
data.limit integer|string
Batas permintaan per menit akun. String unlimited menunjukkan anggaran menit tak terbatas; ini terpisah dari kuota bulanan.
data.remaining integer|string
Slot anggaran menit akun yang tersisa, atau string unlimited. Nilai positif tidak berarti kredit API masih ada.
data.reset integer
Detik untuk jendela menit akun, bukan reset kuota bulanan. Anggaran menit yang dinonaktifkan atau tidak terbatas dapat mempertahankan nilai nominal 60 detik; ini tidak menjamin akses setelah menunggu.
data.plan string
Tag rencana saat ini. Nama rencana yang dapat dibaca disediakan secara terpisah di data.quota.plan_name.
data.quota.enabled boolean
Apakah akses API global dan rencana/kredit diaktifkan. Ini tidak menunjukkan kapasitas yang tersisa atau menggantikan saklar API pengguna.
data.quota.user_api_status boolean
Apakah pengguna telah mengaktifkan saklar API Pengguna mereka. Operasi memerlukan saklar ini serta akses yang diaktifkan dan kapasitas yang tersedia.
data.quota.plan_name string
Nama yang dapat dibaca dari paket saat ini.
data.quota.period string
Periode penggunaan bulan kalender dalam format YYYY-MM, menggunakan zona waktu aplikasi; tidak selalu merupakan periode penagihan langganan.
data.quota.base_limit integer
Tunjangan dasar bulanan paket. Nilai -1 berarti tidak terbatas.
data.quota.extra_requests integer
Tunjangan bulanan tambahan diberikan untuk periode penggunaan saat ini; terpisah dari kredit yang dibeli.
data.quota.monthly_limit integer
Tunjangan dasar ditambah permintaan ekstra periode saat ini. Nilai -1 berarti tidak terbatas. Kredit yang dibeli tidak termasuk.
data.quota.monthly_remaining integer|null
Sisa alokasi bulanan terbatas, atau null ketika kuota bulanan tidak terbatas. Null tidak boleh diartikan sebagai nol.
data.quota.used integer
Operasi API yang berhasil dan dihitung dalam periode penggunaan saat ini, termasuk operasi yang menggunakan kredit. Pemeriksaan status tidak meningkatkan nilai ini.
data.quota.purchased_credits integer
Saldo kredit saat ini, termasuk kredit bonus paket aktif. Kredit bonus tidak boleh ditambahkan ke saldo ini untuk kedua kalinya.
data.quota.bonus_credits integer
Bagian bonus rencana aktif dari saldo kredit; rincian purchased_credits, bukan kapasitas tambahan.
data.quota.direct_purchased_credits integer
Saldo kredit tidak termasuk bagian plan-bonus yang aktif. Nilai ini ditambah bonus_credits sama dengan purchased_credits.
data.quota.remaining integer|null
Sisa alokasi bulanan ditambah saldo kredit saat ini, tanpa menghitung bonus dua kali. Null berarti kuota bulanan tak terbatas. Izin fitur individu dan batas permintaan lainnya tetap berlaku.
data.quota.unlimited boolean
Apakah kuota bulanan tidak terbatas. Ini tidak membuat anggaran menit akun atau batas fitur lainnya tidak terbatas.
data.quota.usage_percent integer
Persentase bulat yang kompatibel dengan dasbor dari 0 hingga 100: digunakan dibagi dengan digunakan ditambah sisa, dikalikan 100. Ini mencakup kapasitas kredit yang tersedia, sehingga pengisian ulang dapat menurunkan persentase. Nilainya 0 untuk kuota tak terbatas atau kumpulan berukuran nol; ini bukan persentase batas laju per menit atau keputusan akses.
data.quota.reset_at string
Stempel waktu ISO-8601 dengan offset zona waktu untuk reset kuota bulan kalender berikutnya. Ini bukan tanggal kedaluwarsa langganan, dan reset bulanan tidak mengisi ulang kredit yang dibeli.
status string
Keberhasilan literal untuk endpoint status ini. Endpoint kotak surat sukses lainnya menggunakan boolean true.
data.monthly_limit integer
Alias kompatibilitas dari bidang data.quota yang bersangkutan; jangan menambahkannya lagi saat menghitung saldo.
data.monthly_remaining integer|null
Alias kompatibilitas dari bidang data.quota yang bersangkutan; jangan menambahkannya lagi saat menghitung saldo.
data.purchased_credits integer
Alias kompatibilitas dari bidang data.quota yang bersangkutan; jangan menambahkannya lagi saat menghitung saldo.

Proteksi PIN Kotak Surat

Masukkan PIN untuk melanjutkan. Kotak surat Anda tetap tidak terkunci selama sesi situs web ini masih aktif.

Apakah Anda menerima cookie?

Kami menggunakan cookie untuk meningkatkan pengalaman menjelajah Anda. Dengan menggunakan situs ini, Anda menyetujui kebijakan cookie kami.

Lebih