A. Pendahuluan

Layanan AI/ML Face Recognition dapat Anda gunakan untuk mengembangkan layanan berbasis pengenalan wajah. Untuk pengenalan dan cara pemesanannya, Anda dapat membaca artikel berikut ini terlebih dulu: Cara Berlangganan Layanan AI/ML (Face Recognition). 

Di artikel kali ini, kita akan mempelajari cara menggunakan layanan Face Recognition. Sebelum lanjut ke cara penggunaan API, penting diketahui tentang topologi Face Recognition, yang menjadi gambaran bagaimana sebuah sistem Face Recognition bekerja.

Dari gambar di atas, terdapat beberapa komponen yang terlibat di dalam sistem. Berikut penjelasan untuk masing-masing:  

• Client merupakan admin atau bisa dibilang sebagai program (aplikasi) Anda yang mengakses API, serta pihak yang memiliki FaceGallery. 
• FaceGallery adalah kumpulan (biasanya dalam bentuk tangkapan foto/gambar) pengguna dari suatu tempat atau area. Anggap saja seperti "database". 
• User adalah orang yang menggunakan API untuk pengenalan wajah dan datanya disimpan pada database. 

B. Konfigurasi

1. Demo dengan Postman

Selanjutnya kita akan mencoba menggunakan produk tersebut melalui postman sebagai software uji coba. Apabila anda belum menginstal postman, silakan dapat mengunduh terlebih dulu pada tautan berikut ini: https://www.postman.com/downloads.

• Jika sudah melakukan instalasi postman, silakan dibuka aplikasinya dan Anda akan melihat tampilan awal seperti berikut:

• Untuk mengakses API anda membutuhkan token sebagai Autentikasi. Adapun token dapat dilihat pada portal https://portal.biznetgio.com di bagian menu AI and ML > Face Recognition > Klik nama service.

• Selanjutnya salin dan simpan pada bagian Token, ini nantinya akan kita gunakan tiap kali melakukan pemanggilan API.

• Selanjutnya kita akan mengeksplorasi bagian Client Endpoint. Pada endpoint ini Anda dapat melihat sisa kuota pemakaian API, berikut contoh penggunaannya melalui postman.

Pertama masukkan URL di bawah ini pada kolom Request URL Postman: 

GET Get Counters (https://fr.neoapi.id/risetai/face-api/client/get-counters) 

Kemudian klik bagian Headers dan tambahkan token yang sudah disalin sebelumnya, isikan bagian header seperti berikut : 

• Key: Accesstoken 
• Value: ISI-TOKEN-YANG-DI-COPY-SEBELUMNYA 

Penambahan token pada Header seperti di atas akan dilakukan pada setiap request atau pemanggilan API. Jadi harap pastikan setiap kali memanggil API, token sudah dimasukkan.

Jika endpoint URL dan token sudah diisi, selanjutnya klik Body untuk mengisi parameter yang dibutuhkan untuk pemanggilan API. Pada bagian Body kita akan menulis parameter dengan format JSON, dan untuk endpoint Get Counters sendiri membutuhkan satu parameter wajib yang harus diisi yaitu:

• Key: trx_id 
• Type: String 
• Description: Key ini digunakan untuk keperluan logging dan debugging, jadi silahkan diisi dengan unique string alphanumeric 

Berikut contohnya : 

Jika sudah diisi Body-nya, selanjutnya klik tombol Send dan pastikan response-nya seperti berikut ini: 

Pada bagian n_api_hits menunjukkan sisa jumlah pemanggilan API yang dapat dilakukan. 

Response di atas muncul saat pemanggilan API-nya berhasil. Sementara berikut contoh pemanggilan API yang gagal karena tidak memasukkan token atau token tidak valid : 

2. Mengelola FaceGallery

#1 GET My Facegalleries (https://fr.neoapi.id/risetai/face-api/facegallery/my-facegalleries) 

Endpoint API ini memberikan List Facegalleries yang Anda miliki. Apabila sebelumnya Anda tidak pernah membuat FaceGallery, maka daftarnya akan kosong. 

Berikut contoh pemanggilan melalui Postman : 

Pada endpoint ini Anda tidak perlu mengisi parameter apapun pada Body, yang harus diisi adalah URL endpoint dan Token pada Header saja.

#2 POST Create Facegalleries (https://fr.neoapi.id/risetai/face-api/facegallery/create-facegallery) 

Pada endpoint ini Anda dapat membuat FaceGallery baru seperti nama lokasi, nama perusahaan, atau nama departemen yang digunakan untuk menyimpan wajah yang diidentifikasi. Endpoint ini memiliki beberapa request Body yang harus dikirim, yaitu: 

• facegallery_id: Isi dengan nama FaceGallery yang ingin dibuat 
• trx_id : isi dengan unique string alphanumeric 

Berikut contoh pemanggilan API melalui Postman:  

Saat membuat FaceGallery, baru Anda harus mengirim request dengan method POST, maka jangan lupa untuk mengganti method pada Postman menjadi POST juga seperti tangkapan layar di atas, dan hasilnya dapat dilihat pada kolom response. 

#3 Delete Delete Facegalleries (https://fr.neoapi.id/risetai/face-api/facegallery/delete-facegallery) 

Endpoint ini digunakan untuk menghapus FaceGallery. Parameternya sama dengan saat membuat FaceGallery sebelumnya, bedanya pada endpoint ini Anda harus menggunakan method Delete.

#4 POST Enroll Face (https://fr.neoapi.id/risetai/face-api/facegallery/enroll-face) 

Pada endpoint ini Anda dapat menambahkan atau register user ke database, endpoint ini mengharuskan anda mengirim 5 parameter pada body 

• user_id : Unique user identifier, bisa diisikan alphanumeric unique seperti NIK, NIM, ID Karyawan atau email address 
• user_name : Nama user yang didaftarkan 
• facegallery_id : Isikan facegallery yang sudah dibuat sebelumnya 
• image : Base64 encoded JPG or PNG image, pada bagian ini kita memasukkan image wajah yang sudah di encode menjadi Base64, pada API kami anda tidak mengupload image sebagai form-data, tetapi anda harus melakukan encode base64 pada image dan mengirim hasil base64 tersebut pada parameter body 
• trx_id : isi dengan unique string alphanumerical

Note: Karena saat ini Anda melakukan pemanggilan API menggunakan postman maka anda dapat melakukan encode image ke base64 melalui website third-party seperti berikut : https://base64.guru/converter/encode/image , jadi pada implementasi nyata anda dapat menggunakan webcam atau camera device untuk meng capture wajah dan melakukan encode ke base64 secara langsung, kemudian barulah hasil encode tersebut di kirim ke API 

Pada capture di atas adalah tampilah salah satu website untuk melakukan encode image ke base64, anda harus upload image dan copy result string base64 seperti capture di atas. 

Apabila sudah dicopy saat nya melakukan request pada postman seperti capture berikut : 

Apabila response yang di dapat adalah Success maka user yang didaftarkan sudah berhasil ditambahkan ke database.

#5 GET List Faces (https://fr.neoapi.id/risetai/face-api/facegallery/list-faces) 

Endpoint ini dapat Anda gunakan untuk melakukan list faces atau wajah yang sudah ditambahkan sebelumnya, endpoint ini menggunakan method GET dan memiliki dua parameter yang harus dikirimkan  

• facegallery_id : Isi dengan nama facegallery yang ingin dibuat 
• Trx_id : isi dengan unique string alphanumerical 

C. Penutupan

Jika Anda membutuhkan layanan untuk menyimpan data wajah untuk keperluan absensi perusahaan, maka layanan Face Recognition cocok untuk kebutuhan Anda.

Semoga artikel ini dapat membantu Anda. Temukan bantuan lainnya melalui Knowledge Base Biznet Gio. Jika Anda masih memiliki kendala silahkan hubungi support@biznetgio.com atau (021) 5714567.