Autentikasi API

Rivya API menggunakan API key untuk akses server-to-server.

API key tidak sama dengan sesi login browser. Jangan gunakan cookie, status session Better Auth, atau token browser pribadi sebagai kredensial API publik.

Format Header

Kirim key di header Authorization:

Authorization: Bearer rvya_sk_...

Key lengkap hanya ditampilkan satu kali saat dibuat. Rivya menyimpan hash dan prefix yang terlihat, bukan secret lengkap.

Membuat Key

1. Masuk ke Rivya.
2. Buka pengaturan API Keys.
3. Buat key dengan scope yang Anda butuhkan.
4. Salin key lengkap segera.
5. Simpan di secret manager sisi server atau variabel environment.

Jangan menaruh key di JavaScript sisi klien, bundle aplikasi mobile, repo publik, event analytics, atau log.

Scope Saat Ini

Versi pertama mendokumentasikan scope berikut:

• models:read
• generations:create
• generations:read
• files:create
• files:read
• credits:read
• webhooks:manage
• chat:create
• chat:read

Key baru yang dibuat di Settings menyertakan scope terdokumentasi ini secara default. Key lama mungkin perlu dibuat ulang sebelum memakai Files API, API Webhooks, atau Chat API.

Mencabut dan Merotasi

Jika sebuah key terekspos:

1. Cabut key lama dari Settings.
2. Buat key baru.
3. Perbarui secret sisi server Anda.
4. Pastikan key baru berfungsi dengan GET /api/v1/credits.
5. Hapus key lama dari sistem build, log, dan variabel deployment.

Key yang dicabut akan mengembalikan api_key_revoked.

Error Autentikasi

Error autentikasi umum:

• api_key_missing
• api_key_invalid
• api_key_revoked
• api_key_expired
• api_scope_denied
• public_api_disabled

Lihat Error dan Limit API untuk tabel error publik lengkap.

Halaman Terkait

• Quickstart API
• Credits API
• Error dan Limit API
• Autentikasi dan Akses di Rivya