Add Employee Facial
เพิ่มรูปใบหน้าลงทะเบียนให้พนักงาน สำหรับใช้ในการลงเวลา
Endpoint
POST /api/v1/open-apis/employee/update-employee?path_action=add-facialQuery Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
path_action | string | Yes | ต้องเป็น add-facial |
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
employee_code | string | Yes | รหัสพนักงาน |
image64 | string | Yes | รูปใบหน้า (Base64 encoded image) — รองรับทั้งแบบมี data URL prefix และไม่มี |
company_id | string | No | รหัสบริษัท — ใช้เฉพาะเมื่อพนักงานยังไม่มี company_id ในระบบ |
image64 รองรับทั้งแบบ "data:image/jpeg;base64,/9j/4AAQ..." และแบบ raw base64 "/9j/4AAQ..." (ระบบจะเติม prefix ให้อัตโนมัติ)
Response Format
Success Response
{
"code": 200,
"message": "Add Facial Success",
"payload": {
"employee_code": "EMP001",
"employee_id": "20260121FC89F3BB9120",
"image64": "https://openapi.humansoft.co.th/files/employee/facial/aBcDeFgHiJkLmNoPqRsTuVwXyZ1234.jpg",
"employee_facial_id": "20260213FA01B2C3D4E5"
}
}Response Fields
| Field | Type | Description |
|---|---|---|
employee_code | string | รหัสพนักงาน |
employee_id | string | ID ของพนักงาน |
image64 | string | URL ของรูปภาพที่อัพโหลด |
employee_facial_id | string | ID ของข้อมูลใบหน้าที่สร้าง |
ฟิลด์ image64 ใน response จะเป็น URL ของไฟล์ที่อัพโหลดแล้ว ไม่ใช่ base64 data
Error Response
{
"code": 400,
"message": "ข้อมูลไม่ถูกต้อง",
"errors": [
"กรุณาระบุ 'employee_code'",
"กรุณาระบุ 'image64' (รูปภาพ base64)"
]
}| เงื่อนไข | Error Message |
|---|---|
ไม่ส่ง employee_code | กรุณาระบุ 'employee_code' |
ไม่ส่ง image64 | กรุณาระบุ 'image64' (รูปภาพ base64) |
| หา employee ไม่เจอ | Employee not found with code: xxx |
| พนักงานไม่มี company_id | กรุณาระบุ company_id ... |
| ลงทะเบียนใบหน้าไม่สำเร็จ | ไม่สามารถลงทะเบียนใบหน้าได้ |
Code Examples
cURL
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee?path_action=add-facial" \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-d '{
"employee_code": "EMP001",
"image64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQAB..."
}'Related APIs
- List Facial - ดึงรายการข้อมูลใบหน้าทั้งหมด
- Delete Facial - ลบข้อมูลใบหน้า
Last updated on