Keyspace API

Keyspace

Manajemen namespace database. Gunakan keyspace untuk memisahkan data antar tenant, departemen, atau use-case dalam satu deployment FREMIS-N.

Membuat Keyspace Baru

Membuat namespace database baru untuk mengelompokkan enrollment wajah. Setiap keyspace adalah ruang terisolasi yang menyimpan vektor wajah unik. Gunakan endpoint ini untuk menginisialisasi keyspace sebelum melakukan enrollment.

curl -X POST "https://fremis-n.example.com/v1/face/keyspace" \  -H "Content-Type: application/json" \  -d '{    "keyspace": "karyawan-jakarta",    "keyspace_id": 1  }'

{  "keyspace": "karyawan-jakarta"}

"Can't create new keyspace, keyspace limit is exceeded"

Mendapatkan Informasi Keyspace

Mengambil informasi detail keyspace tertentu, termasuk nama dan ID-nya. Endpoint ini berguna untuk verifikasi keberadaan keyspace atau retrieve ID numerik untuk operasi lain.

curl -X GET "https://fremis-n.example.com/v1/face/keyspace/karyawan-jakarta"

{  "keyspace": "karyawan-jakarta",  "id": 123}

Menghapus Keyspace

Menghapus keyspace dan semua data enrollment wajah yang terdapat di dalamnya secara permanen. Operasi ini tidak dapat diurungkan. Pastikan keyspace tidak lagi digunakan sebelum menghapus.

curl -X DELETE "https://fremis-n.example.com/v1/face/keyspace/karyawan-jakarta"

"string"

Menghitung Jumlah Keyspace

Mengambil total jumlah keyspace yang tersedia di service FREMIS-N. Endpoint ini membantu monitoring kapasitas atau validasi limit keyspace dalam sistem.

curl -X GET "https://fremis-n.example.com/v1/get-keyspaces-count"

{  "keyspaces_count": 15}

Mendapatkan Daftar Semua Keyspace

Mengambil array lengkap nama semua keyspace dalam sistem FREMIS-N. Berguna untuk enumerasi keyspace, validasi, atau keperluan UI yang menampilkan daftar keyspace yang tersedia.

curl -X GET "https://fremis-n.example.com/v1/get-all-keyspaces"

{  "keyspaces": [    "karyawan-jakarta",    "vip-customers",    "watchlist-keamanan"  ]}

Menghitung Jumlah Vektor dalam Keyspace

Mengambil statistik enrollment dalam keyspace tertentu — total ID vektor dan total variasi vektor. Berguna untuk monitoring kapasitas keyspace atau analisis pertumbuhan enrollment.

curl -X GET "https://fremis-n.example.com/v1/get-vector-count/karyawan-jakarta"

{  "keyspace": "karyawan-jakarta",  "total_vector_ids": 500,  "total_vector_variations": 2500}