Kauny Mail API
Buat alamat email instan di @kaunycatering.my.id, terima pesan secara realtime, dan ekstrak kode OTP lewat satu endpoint long-poll. Semua email masuk ditulis ke D1 dalam hitungan detik.
01 Autentikasi
Kirim key lewat header X-API-Key (atau Authorization: Bearer). Key bot di bawah sudah punya scope read + write — cukup untuk semua operasi email, tidak bisa mengelola key atau pengaturan.
https://kauny-mail.maxluno47.workers.devkmail_v2_80baa0f37c9e409e3433ea8eeaf9fcfa6ec21ce34416befbX-API-Key: kmail_v2_80baa0f…*@kaunycatering.my.idcatch-all otomatis02 Quickstart
Dua langkah: buat inbox, lalu tunggu email masuk sambil minta kode diekstrak otomatis.
03 Endpoint
Semua respons JSON. Endpoint v1 lama (/api/inbox, /api/inboxes, /api/recent, /api/search) masih berfungsi.
Body JSON { "local": "user123" }. Kosongkan local untuk nama acak acc…. Karakter valid: huruf kecil, angka, titik, underscore, dash.
{"ok":true,"address":"user123@kaunycatering.my.id","created":true}
Body { "count": 50, "prefix": "twitter" }. count 1–100 (di-clamp), prefix opsional. Tanpa prefix, nama dibuat acak acc…; dengan prefix, hasilnya <prefix>-<acak>.
{"ok":true,
"created":["twitter-1a2b3c4d@kaunycatering.my.id",
"twitter-9f8e7d6c@kaunycatering.my.id", ...],
"count":50}
Endpoint inti untuk farming akun. Satu panggilan melakukan semuanya: membuat inbox unik, menunggu email masuk (long-poll), mengekstrak kode, dan mengosongkan inbox bila diminta. Tanpa state, tanpa tiga panggilan terpisah.
| Parameter | Keterangan |
|---|---|
| wait | 0–30 detik menunggu email (bawaan 20) |
| sender | filter pengirim — hanya email dari alamat/brand itu yang dianggap. Berguna kalau situs mengirim email welcome sebelum kode |
| local | prefiks alamat: local=A1 → a1-x7k9pz@…. Tanpa ini, nama acak farm… |
| consume | 1 = isi inbox dihapus setelah dibaca → aman dipakai ulang untuk akun berikutnya |
{"ok":true,
"address":"tw-3f9a2b@kaunycatering.my.id",
"inbox": "tw-3f9a2b@kaunycatering.my.id",
"code":"703901",
"subject":"Confirm your email",
"from":"security@account.meta.com",
"links":["https://…"],
"text":"Confirmation code 703901 …",
"received_at":"2026-11-18T03:14:20.081Z"}
ok:false berarti timeout tanpa email — field waited berisi detik yang tersia. Bot tinggal retry dengan alamat baru.
grab → pakai address di form daftar akun situs → kode OTP ada di code, magic link di links[0] → selesai. Ulangi untuk akun berikutnya. Satu baris HTTP per akun.Izin minimal: scope read + write cukup — tidak perlu admin.
| Parameter | Keterangan |
|---|---|
| address | wajib — alamat lengkap di domain kauny |
| wait | 0–30 detik, menahan koneksi sampai pesan berikutnya masuk |
| code | 1 = tunggu sampai ada pesan dengan kode terdeteksi |
| limit | 1–200 pesan, bawaan 100 |
| since | ISO timestamp — hanya pesan setelah waktu itu |
{"ok":true,"inbox":"user123@kaunycatering.my.id","found":true,
"messages":[{"id":"<…@mail>","from":"security@account.meta.com",
"subject":"Confirm your email","code":"703901","links":[...],
"received_at":"2026-11-18T03:14:20.081Z"}],
"latest":{"code":"703901", ...}}
Mengembalikan alamat terdaftar maupun alias yang muncul karena menerima email (auto: true), lengkap dengan jumlah pesan.
Query ?limit=40&since=ISO. Lintas semua alamat, diurutkan terbaru dulu.
Query ?q=token, opsional address=… dan limit=…. Mencari subjek, pengirim, isi, alamat, dan kode.
Respons: {"ok":true,"inbox":"…","deleted":true,"messages_deleted":12}.
Body {"addresses":["a@…","b@…"]}, maksimal 200 alamat per panggilan.
Menghasilkan file <local>-export.json berisi seluruh pesan alamat itu (maks 200).
Total inbox/pesan/kode, aktivitas 24 jam & 7 hari, top pengirim, dan deretan 14 hari terakhir.
04 Pola long-poll OTP
Worker menahan koneksi hingga wait detik dan mengecek D1 tiap 1,2 detik. Begitu pesan dengan kode masuk, respons langsung dikirim — jangan menunggu penuh 30 detik.
POST /api/v2/inboxes { "local": "verify01" }verify01@kaunycatering.my.idGET /api/v2/inbox?address=…&wait=30&code=1data.latest.code atau data.latest.linkscode akan null — ambil URL dari latest.links. Ekstraktor hanya menangkap angka 4–8 digit atau alfanumerik setelah kata code/otp/pin/kode.GET /api/v2/grab — lihat bagian farming di daftar endpoint.05 Farming akun
Playbook lengkap men-farm daftar akun di situs mana pun memakai Kauny Mail sebagai penyedia email verifikasi.
Pola dasar — satu akun = satu panggilan
Skala besar
POST /api/v2/inboxes/batch {"count":100,"prefix":"farm"}banyak grab serentak dengan key read/write terpisahwrite 90/menit per key — pakai beberapa key bila perluconsume=1 → inbox kosong lagi, siap dipakai ulangkartu "Grab 24 jam" di /admin + audit action=grabTips praktis
sender= kalau situs mengirim email lebih dari satu (welcome dulu, kode belakangan). Tanpa filter, grab bisa menangkap email yang salah.local=NamaAkun + consume=1 — alamat deterministik per slot farm (slot01-x9k2@…), mudah ditelusuri di audit.DELETE /api/v2/inbox/bulk {"addresses":[…]} atau purge harian dari panel.*.workers.dev diblokir DNS beberapa ISP Indonesia (XL, dst.) — bot di mesin rumah perlu DNS-over-HTTPS (browser: Secure DNS) atau VPN. Di VPS biasanya langsung tembus.06 Webhook
Atur URL dan secret lewat /admin → Pengaturan. Tiap pesan masuk dikirim POST dengan tanda tangan HMAC-SHA256 di header X-Kauny-Signature (hex dari body persis).
{
"event": "message",
"service": "kauny-mail",
"version": "2.0.0",
"at": "2026-11-18T03:14:20.081Z",
"data": {
"id": "<message-id@host>",
"to": "user123@kaunycatering.my.id",
"from": "security@account.meta.com",
"subject": "Confirm your email",
"code": "703901",
"links": ["https://…"],
"received_at": "2026-11-18T03:14:20.081Z"
}
}
POST /api/v2/settings/test-webhook.07 Error & batas
| Status | Artinya |
|---|---|
| 400 | Alamat bukan @kaunycatering.my.id atau parameter tidak valid |
| 401 | Key hilang, salah, atau sudah dicabut |
| 403 | Scope kurang — misal key read dipakai untuk menulis |
| 404 | Rute tidak ada |
| 429 | Rate limit terlampaui: 600 read / 90 write / 120 admin per menit per key |
| 500 | Gangguan internal; detail ada di field detail |
8 MB — sisanya dipotong, email tetap tersimpan90 hari — bisa diubah di /admin* — bisa dipanggil langsung dari browser08 Kompatibilitas v1
Endpoint lama masih aktif dan memakai key legasi dari environment. Rute-rutenya:
POST /api/inboxGET /api/inbox?address=…&wait=30&code=1/api/inboxes · /api/recent · /api/search/api/health — publik/api/v2/* dengan key kmail_v2_… supaya bisa dirotasi per aplikasi dan punya audit sendiri.