Face Enroll API

Endpoint ini memungkinkan Anda untuk menambahkan gambar wajah baru ke database pribadi Anda.

Endpoint

POST /v1/face/enroll

Request Parameters

Parameter	Type	Required	Description
database_name	string	Yes	Nama database tempat gambar akan disimpan
image_base64	string	Yes	Gambar wajah dalam format base64
metadata	object	No	Metadata tambahan dalam format JSON

Request Example

{
  "database_name": "default",
  "image_base64": "data:image/jpeg;base64,...",
  "metadata": {
    "name": "John Doe",
    "employee_id": "EMP123",
    "department": "IT"
  }
}

Metadata

Field metadata bersifat opsional dan fleksibel. Anda bebas memasukkan data apa saja selama format JSON valid. Contoh metadata yang umum digunakan:

• name - Nama orang
• employee_id - ID karyawan
• department - Departemen
• email - Alamat email
• phone - Nomor telepon
• notes - Catatan tambahan

Response

Success Response

{
  "message": "Image uploaded and database indexed successfully",
  "data": {
    "image_id": "DO46s5vDwayAFMVANMkM",
    "enroll_status": true
  }
}

Response Fields

Field	Type	Description
message	string	Status message
data.image_id	string	ID unik untuk gambar yang disimpan
data.enroll_status	boolean	Status pendaftaran wajah

Automatic Indexing

Setiap kali gambar diunggah melalui endpoint /v1/face/enroll, database secara otomatis di-indexing untuk mempercepat pencarian di masa mendatang.

Error Responses

400 Bad Request

{
  "error": "Invalid image format",
  "message": "Image must be in base64 format"
}

401 Unauthorized

{
  "error": "Invalid API key",
  "message": "Please provide a valid API key"
}

422 Unprocessable Entity

{
  "error": "No face detected",
  "message": "Could not detect a face in the provided image"
}