Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Add Employee Facial

เพิ่มรูปใบหน้าลงทะเบียนให้พนักงาน สำหรับใช้ในการลงเวลา

Endpoint

POST /api/v1/open-apis/employee/update-employee?path_action=add-facial

Query Parameters

ParameterTypeRequiredDescription
path_actionstringYesต้องเป็น add-facial

Request Body

ParameterTypeRequiredDescription
employee_codestringYesรหัสพนักงาน
image64stringYesรูปใบหน้า (Base64 encoded image) — รองรับทั้งแบบมี data URL prefix และไม่มี
company_idstringNoรหัสบริษัท — ใช้เฉพาะเมื่อพนักงานยังไม่มี 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

FieldTypeDescription
employee_codestringรหัสพนักงาน
employee_idstringID ของพนักงาน
image64stringURL ของรูปภาพที่อัพโหลด
employee_facial_idstringID ของข้อมูลใบหน้าที่สร้าง

ฟิลด์ 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 -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..." }'

  • List Facial - ดึงรายการข้อมูลใบหน้าทั้งหมด
  • Delete Facial - ลบข้อมูลใบหน้า
Last updated on