Autentikasi & Batas Pemakaian

Semua endpoint /v1 (kecuali webhook status provider) memakai API key sebagai Bearer token.

Authorization: Bearer ntf_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

• Key dibuat di Console → Settings → API Keys dan hanya tampil sekali. Notifora hanya menyimpan hash SHA-256, awalan, dan 4 karakter terakhir.
• Key terikat ke satu environment. Key ntf_test_ tidak bisa memicu workflow di Production.
• Mencabut key berlaku langsung (HTTP 401 pada panggilan berikutnya).
• Pembuatan dan pencabutan key dicatat di audit log, dan admin workspace menerima email peringatan.

Setiap workspace punya dua environment dengan data terpisah penuh. Gunakan Development untuk integrasi dan pengujian, lalu daftarkan ulang workflow dan provider di Production.

Dua batas berbeda berlaku: rate limit (request per menit per API key) dan kuota event (jumlah trigger per bulan per environment).

Setiap respons memuat header:

X-RateLimit-Limit: 600
X-RateLimit-Remaining: 598
X-RateLimit-Reset: 1793097600     # epoch detik

• Melewati rate limit → 429 rate_limited dengan header Retry-After (detik). Coba lagi dengan exponential backoff.
• Kuota event: peringatan email di 80% dan 100%. Setelah 100% ada toleransi 10%; setelahnya event baru ditolak dengan 402 quota_exceeded sampai bulan berikutnya atau plan di-upgrade.
• Pemakaian aktual: Console → Settings → Usage.

Kirim header X-Idempotency-Key (maks. 191 karakter) pada POST /events/trigger agar retry jaringan tidak mengirim notifikasi dua kali. Berlaku 24 jam per environment.