Documentation

Semua yang perlu kamu tahu untuk mulai integrasi dengan RannzAPI.

Getting Started

Daftar akun, ambil API key kamu dari /dashboard, lalu kirim request pertama ke salah satu endpoint Free — misalnya /v1/uuid. Semua endpoint memakai base URL https://api.rannzdigital.web.id.

Authentication

Setiap request wajib menyertakan header X-API-Key. Tidak ada OAuth atau session cookie untuk API — cukup satu key per akun.

API Keys

API key dibuat otomatis saat register, formatnya rz_live_xxxxxxxxxxxxxxxxx. Kamu bisa revoke dan regenerate kapan saja dari dashboard — key lama langsung berhenti berfungsi.

Rate Limits

Setiap API punya limit berbeda (lihat halaman detail masing-masing API). Limit dihitung per akun, bukan per IP, dan direset sesuai periode yang tertulis di card API.

Errors

Semua error mengikuti format konsisten: { success: false, error: { code, message } }. Kode umum: INVALID_API_KEY, INVALID_PARAM, PREMIUM_REQUIRED, RATE_LIMIT_EXCEEDED.

APIs

Katalog lengkap ada di /apis. Setiap API punya halaman detail dengan parameter, contoh response, dan console coba-langsung.

Examples

Contoh kode tersedia dalam cURL, JavaScript, Python, dan PHP di setiap halaman detail API — tinggal salin dan ganti YOUR_API_KEY.

Security

Jangan pernah menaruh API key di kode frontend atau repository publik. Simpan sebagai environment variable di server kamu, dan proxy request lewat backend milikmu sendiri jika perlu dipanggil dari browser.