Menu dokumentasi
Dokumentasi → API & Webhook → API Quickstart
Di halaman ini
Base URLAuthGenerate addressList messagesGet message detailRate limits

API Quickstart

REST API Cloudin untuk integrasi server-to-server (bot, otomasi, dll).

Base URL

kode
https://api.cloudin.id/v1

Auth

Pakai API key di header X-API-Key. Generate key di Layanan → API Keys → Buat key.

Catatan

Key hanya muncul sekali saat dibuat. Catat di password manager.

bash
curl -H "X-API-Key: clk_live_xxx" https://api.cloudin.id/v1/services/SVC_ID/addresses

Generate address

bash
curl -X POST https://api.cloudin.id/v1/services/SVC_ID/addresses \
  -H "X-API-Key: clk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "domainId": "DOMAIN_ID"
  }'

Response:

json
{
  "data": {
    "id": "01HXY...",
    "fullAddress": "abc12@inbox.brandkamu.id",
    "expiresAt": "2036-05-28T08:00:00Z",
    "ttlSeconds": 0
  }
}

> Catatan: Address bersifat permanen (model Mailinator) — tidak ada TTL. Field expiresAt selalu berisi tanggal far-future dan ttlSeconds selalu 0; keduanya dipertahankan untuk kompatibilitas, bukan sebagai janji kedaluwarsa. Address idle yang tidak pernah menerima email akan dibersihkan otomatis setelah 90 hari. Untuk berhenti menerima email, hapus address-nya.

List messages

bash
curl -H "X-API-Key: clk_live_xxx" \
  https://api.cloudin.id/v1/inboxes/abc12@inbox.brandkamu.id/messages

Get message detail

bash
curl -H "X-API-Key: clk_live_xxx" \
  https://api.cloudin.id/v1/messages/MSG_ID

Rate limits

  • 1000 requests / menit per key
  • 30 requests / menit per IP (untuk endpoint public)
Header response:
  • X-RateLimit-Remaining — sisa quota
  • X-RateLimit-Limit — limit
← Sambungkan domain & DNSAutentikasi →