Kembali ke docs

API Quickstart

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

Base URL

https://api.cloudin.id/v1

Auth

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

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

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

Generate address

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",
    "ttlSeconds": 600
  }'

Response: 

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

List messages

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

Get message detail

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