Skip to Content
🚀 Welcome to Humansoft Open API Documentation

List Employee Facial

ดึงรายการรูปใบหน้าที่ลงทะเบียนทั้งหมดของพนักงาน

Endpoint

GET /api/v1/open-apis/employee/get-employee-data-filter?path_action=list-facial

Query Parameters

ParameterTypeRequiredDescription
path_actionstringYesต้องเป็น list-facial
employee_codestringYesรหัสพนักงาน

Response Format

Success Response

{ "code": 200, "message": "สำเร็จ", "payload": [ { "employee_facial_id": "20260213FA01B2C3D4E5", "employee_id": "20260121FC89F3BB9120", "reference_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "documents_name": "aBcDeFgHiJkLmNoPqRsTuVwXyZ1234.jpg", "documents_path": "https://openapi.humansoft.co.th/files/employee/facial/aBcDeFgHiJkLmNoPqRsTuVwXyZ1234.jpg" } ] }

Response Fields

FieldTypeDescription
employee_facial_idstringID ของข้อมูลใบหน้า
employee_idstringID ของพนักงาน
reference_idstringรหัสอ้างอิงใบหน้า
documents_namestringชื่อไฟล์รูป
documents_pathstringURL ของรูปภาพ

Error Response

{ "code": 400, "message": "ไม่สำเร็จ", "error": "Missing required parameter: employee_code" }
เงื่อนไขError Message
ไม่ส่ง employee_codeMissing required parameter: employee_code
หา employee ไม่เจอEmployee not found with code: xxx

Code Examples

curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/employee/get-employee-data-filter?path_action=list-facial&employee_code=EMP001" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -H "Content-Type: application/json"

Notes

พนักงานแต่ละคนสามารถมีรูปใบหน้าได้หลายรูป แต่ละรูปจะมี employee_facial_id แยกกัน หากได้ payload เป็น array ว่าง แสดงว่าพนักงานยังไม่มีรูปใบหน้าในระบบ


  • Add Facial - เพิ่มข้อมูลใบหน้า
  • Delete Facial - ลบข้อมูลใบหน้า
Last updated on