Kunci API email sementara untuk pengujian email otomatis

Daftar domain publik aktif

Mengembalikan domain yang tersedia untuk membuat alamat saat ini. Fungsi publik ini tidak memerlukan kunci API atau memakai kuota. Domain pribadi GPTMail tidak disertakan.

curl -sS "https://cleantempmail.com/api/domains?limit=100"

{
  "success": true,
  "data": {
    "domains": ["domain-one.example", "domain-two.example"],
    "total": 1832,
    "offset": 0,
    "limit": 100
  }
}

Buat alamat email sementara

GET membuat alamat dengan awalan yang dihasilkan dan domain aktif acak. POST dapat menentukan awalan, domain, atau keduanya. Alamat akhir selalu dikembalikan dalam data.email.

curl -sS \
  -H "X-API-Key: ct-test" \
  "https://cleantempmail.com/api/generate-email"

curl -sS -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"prefix":"qa.user","domain":"your-active-domain.com"}' \
  "https://cleantempmail.com/api/generate-email"

Jika domain yang diminta tidak lagi aktif, API mengembalikan HTTP 409 alih-alih diam-diam mengganti domain.

Daftar pesan dalam kotak masuk

Mengembalikan hingga 500 pesan terbaru untuk satu alamat publik CleanTempMail. Kotak masuk baru atau kosong mengembalikan emails: [] dan count: 0.

curl -sS -G \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "[email protected]" \
  "https://cleantempmail.com/api/emails"

{
  "success": true,
  "data": {
    "emails": [
      {
        "id": "66c123example",
        "email_address": "[email protected]",
        "from_address": "[email protected]",
        "subject": "Your verification code",
        "content": "Your code is 123456",
        "html_content": "<p>Your code is <b>123456</b></p>",
        "has_html": true,
        "attachments": [
          {
            "id": "attachment-id",
            "filename": "receipt.pdf",
            "content_type": "application/pdf",
            "size": 48231
          }
        ],
        "timestamp": 1787702400,
        "raw_size": 51984,
        "created_at": "2026-08-25T12:00:00Z"
      }
    ],
    "count": 1
  },
  "usage": { "daily_limit": 100, "used_today": 2, "remaining_today": 98, "total_limit": 1000, "total_used": 2, "remaining_total": 998 }
}

Ambil satu pesan lengkap

Menggunakan id dari /api/emails untuk mengambil satu pesan, termasuk teks/HTML, header, stempel waktu, dan metadata lampiran. Data biner lampiran tidak disematkan dalam JSON.

curl -sS \
  -H "X-API-Key: YOUR_API_KEY" \
  "https://cleantempmail.com/api/email/66c123example"

Kolom email penting

Unduh lampiran

Unduh satu lampiran sebagai berkas biner. Gunakan id email dan attachments[].id dari GET /api/email/{id}. Setiap unduhan memakai 1 permintaan API.

curl -fL -OJ \
  -H "X-API-Key: YOUR_API_KEY" \
  "https://cleantempmail.com/api/email/66c123example/attachment/attachment-id"

Isi respons adalah berkas itu sendiri. Server menetapkan Content-Type, Content-Length, dan Content-Disposition. curl -OJ menyimpan dengan nama berkas aman dari server. Kesalahan lampiran dikembalikan sebagai teks biasa.

Hapus satu pesan

Menghapus permanen pesan berdasarkan id. Ambil ID dari /api/emails terlebih dahulu. Tindakan ini tidak dapat dibatalkan.

curl -sS -X DELETE \
  -H "X-API-Key: YOUR_API_KEY" \
  "https://cleantempmail.com/api/email/66c123example"

{"success":true,"data":{"message":"Email deleted"},"usage":{"daily_limit":100,"used_today":4,"remaining_today":96,"total_limit":1000,"total_used":4,"remaining_total":996}}

Kosongkan kotak masuk

Menghapus permanen semua pesan tersimpan untuk kotak surat publik yang diberikan dan mengembalikan jumlah yang dihapus. Tindakan ini tidak dapat dibatalkan.

curl -sS -X DELETE -G \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "[email protected]" \
  "https://cleantempmail.com/api/emails/clear"

{"success":true,"data":{"message":"Deleted 3 emails","count":3},"usage":{"daily_limit":100,"used_today":5,"remaining_today":95,"total_limit":1000,"total_used":5,"remaining_total":995}}

Endpoint statistik

Mengembalikan statistik layanan publik dari cache. Setiap jalur adalah permintaan terlindungi terpisah dan memakai 1 permintaan. Email domain pribadi dikecualikan dari statistik publik.

curl -sS \
  -H "X-API-Key: YOUR_API_KEY" \
  "https://cleantempmail.com/api/stats"

{
  "success": true,
  "data": {
    "total_emails": 1250000,
    "today_emails": 32000,
    "emails_24h": 41000,
    "unique_subjects": 8600,
    "active_domains": 1832
  },
  "usage": { "daily_limit": 100, "used_today": 6, "remaining_today": 94, "total_limit": 1000, "total_used": 6, "remaining_total": 994 }
}

Periksa kuota kunci API

Mengembalikan status dan penggunaan kunci yang dibeli, dibuat manual, habis, atau kunci uji bersama. Pemeriksaan ini tidak memakai kuota. Kirim kunci melalui X-API-Key atau kolom JSON api_key; penggunaan header disarankan.

curl -sS -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  "https://cleantempmail.com/api/api-key/usage"

curl -sS -X POST \
  -H "Content-Type: application/json" \
  --data '{"api_key":"ct-test"}' \
  "https://cleantempmail.com/api/api-key/usage"

{
  "success": true,
  "data": {
    "masked_key": "••••••••wxyz",
    "status": "active",
    "is_active": true,
    "daily_limit": 100,
    "used_today": 6,
    "remaining_today": 94,
    "total_limit": 1000,
    "total_used": 6,
    "remaining_total": 994
  }
}

status berisi active, exhausted, atau inactive. Kunci yang dibeli dan sudah habis tetap dapat diperiksa. Kunci lengkap serta metadata Stripe/pelanggan tidak pernah dikembalikan.