Autentikasi dan API key

Setiap permintaan ke API memakai API key di header x-api-key. Sebuah key bertindak sebagai pengguna pemiliknya: peran, outlet, dan izinnya sama persis, dan diperiksa ulang di setiap permintaan.

Disarankan: buat API user

Daripada memakai key di akun orang, buat API user khusus untuk integrasi. API user tidak bisa login, awalnya tidak punya izin sama sekali, dan Anda memberinya hanya izin yang dibutuhkan integrasi.

Masuk sebagai pemilik (owner) organisasi.
Buka Settings → API Keys, lalu pilih Create API User.
Buka halaman anggota API user tersebut dan berikan izin yang dibutuhkan (misalnya hanya membaca produk dan stok), serta outlet yang boleh diaksesnya.
Kembali ke Settings → API Keys dan buat key untuk API user itu.

Membuat key

Masa berlaku wajib: 1–365 hari (bawaan 90 hari). Key yang kedaluwarsa ditolak. Pemilik akan menerima pengingat sebelum key kedaluwarsa.
Daftar IP (opsional): alamat IPv4/IPv6 atau CIDR, satu per baris. Kosong berarti semua IP. Gunakan untuk integrasi server ke server dengan IP tetap.
Hanya ditampilkan sekali. Salin key segera setelah dibuat. Medivy hanya menyimpan hash-nya, jadi key yang hilang tidak bisa dilihat lagi. Cabut, lalu buat key baru.

Memakai key

curl -H "x-api-key: mdv_…" https://api.medivy.id/api/dash/<orgId>/products

<orgId> adalah ID organisasi Anda. Untuk endpoint per outlet (/outlets/<outletId>/…), pengguna key harus ditugaskan ke outlet tersebut.

Menonaktifkan dan mencabut

Di Settings → API Keys Anda bisa menonaktifkan, mengaktifkan kembali, atau mencabut key. Perubahan berlaku pada permintaan berikutnya. Setiap tindakan tercatat di log audit, dan setiap key menampilkan waktu serta IP terakhir dipakai.