List Employee Facial
ดึงรายการรูปใบหน้าที่ลงทะเบียนทั้งหมดของพนักงาน
Endpoint
GET /api/v1/open-apis/employee/get-employee-data-filter?path_action=list-facialQuery Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
path_action | string | Yes | ต้องเป็น list-facial |
employee_code | string | Yes | รหัสพนักงาน |
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
| Field | Type | Description |
|---|---|---|
employee_facial_id | string | ID ของข้อมูลใบหน้า |
employee_id | string | ID ของพนักงาน |
reference_id | string | รหัสอ้างอิงใบหน้า |
documents_name | string | ชื่อไฟล์รูป |
documents_path | string | URL ของรูปภาพ |
Error Response
{
"code": 400,
"message": "ไม่สำเร็จ",
"error": "Missing required parameter: employee_code"
}| เงื่อนไข | Error Message |
|---|---|
ไม่ส่ง employee_code | Missing required parameter: employee_code |
| หา employee ไม่เจอ | Employee not found with code: xxx |
Code Examples
cURL
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 ว่าง แสดงว่าพนักงานยังไม่มีรูปใบหน้าในระบบ
Related APIs
- Add Facial - เพิ่มข้อมูลใบหน้า
- Delete Facial - ลบข้อมูลใบหน้า
Last updated on