Add Employee Setting
Router สำหรับเพิ่มข้อมูลการตั้งค่าพนักงาน รองรับการเรียกใช้งานแบบแยกเรื่องผ่าน path_action parameter
API นี้ใช้ Router Pattern - ระบุ path_action เพื่อเลือกประเภทการตั้งค่าที่ต้องการเพิ่ม
Endpoint
POST /api/v1/open-apis/employee/add-employee-settingQuery Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
path_action | string | Yes | ประเภทข้อมูลที่ต้องการเพิ่ม |
Base Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
employee_code | string | Yes | รหัสพนักงาน |
ใช้ employee_code เพื่อระบุพนักงาน
พารามิเตอร์ที่ลงท้ายด้วย _id ต้องส่งเป็น Base64-encoded ของ raw internal ID
- Response จะ return raw string ID (เช่น
20260121FC89F3BB9120) - เมื่อนำ ID จาก response ไปใช้ใน request ถัดไป ต้อง encode เป็น Base64 ก่อน
Supported Actions
| path_action | Description | Required Params |
|---|---|---|
user | เพิ่มบัญชีผู้ใช้งานใหม่ | employee_code |
actual-quota | เพิ่มโควตาการลาจริง | employee_code, quota_id, work_date, leave_value |
facial | เพิ่มใบหน้าสำหรับลงเวลา | employee_code, image64 |
Action Details
1. user - เพิ่มบัญชีผู้ใช้งานใหม่
สร้างบัญชีผู้ใช้งานใหม่ให้กับพนักงาน
Request Body:
| Parameter | Type | Required | Description |
|---|---|---|---|
user_name | string | Yes | ชื่อผู้ใช้ |
Auto Actions:
- Normalize Username (แปลงเป็นตัวพิมพ์เล็ก)
- Set User Type = ‘hrs’
- Set First Sign-in Flag = ‘Y’
- Assign Default User Group
Response:
{
"code": 200,
"message": "Add User Success",
"payload": {
"user_id": "20260121PS01B2C3D4E5",
"user_name": "somchai.j",
"employee_code": "EMP001",
"user_type": "hrs",
"first_singin_flag": "Y"
}
}พนักงาน 1 คนมีได้ 1 บัญชี ถ้ามีอยู่แล้วให้ใช้ reset_username หรือ reset_password แทน
2. actual-quota - เพิ่มโควตาการลาจริง
เพิ่มจำนวนวันลาที่ใช้จริงของพนักงาน
Request Body:
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
quota_id | string | Yes | ID ของโควตา (Base64) | "MjAyNjAxMTVRVDAxQTJCM0M0RDU=" |
work_date | string | Yes | วันที่ลา (YYYY-MM-DD) | "2026-06-15" |
leave_value | string | Yes | จำนวนวันลา | "1" |
remark | string | No | หมายเหตุ | "ลาป่วยเพิ่มเติม" |
Response:
{
"code": 200,
"message": "Add Actual Quota Success",
"payload": {
"actual_quota_id": "20260121PS01B2C3D4E5",
"quota_id": "QT001",
"work_date": "2024-06-15",
"leave_value": "1"
}
}3. facial - เพิ่มใบหน้าสำหรับลงเวลา
เพิ่มรูปใบหน้าพนักงานสำหรับระบบลงเวลา
Request Body:
| Parameter | Type | Required | Description |
|---|---|---|---|
image64 | string | Yes | รูปภาพ Base64 encoded |
Response:
{
"code": 200,
"message": "Add Facial Success",
"payload": {
"employee_facial_id": "20260121PS01B2C3D4E5",
"employee_code": "EMP001",
"documents_path": "https://openapi.humansoft.co.th/files/employee/facial/aBcDeFgHiJkLmNoPqRsTuVwXyZ1234.jpg"
}
}รูปภาพควรเห็นใบหน้าชัดเจน หันตรง แสงสว่างเพียงพอ
Error Response
{
"code": 400,
"message": "ข้อมูลไม่ถูกต้อง",
"errors": [
"กรุณาระบุ 'path_action'",
"กรุณาระบุ 'employee_code'"
]
}Code Examples
cURL
# เพิ่มบัญชีผู้ใช้งานใหม่
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/add-employee-setting?path_action=user" \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-d '{
"employee_code": "EMP001",
"user_name": "somchai.j"
}'
# เพิ่มโควตาการลาจริง
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/add-employee-setting?path_action=actual-quota" \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-d '{
"employee_code": "EMP001",
"quota_id": "MjAyNjAxMTVRVDAxQTJCM0M0RDU=",
"work_date": "2026-06-15",
"leave_value": "1",
"remark": "ลาป่วยเพิ่มเติม"
}'
# เพิ่มใบหน้าสำหรับลงเวลา
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/add-employee-setting?path_action=facial" \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-d '{
"employee_code": "EMP001",
"image64": "data:image/jpeg;base64,/9j/4AAQ..."
}'Troubleshooting
| Error | Solution |
|---|---|
| กรุณาระบุ ‘path_action’ | ต้องระบุ path_action ใน query parameter |
| กรุณาระบุ ‘employee_code’ | ต้องระบุ employee_code |
| ไม่พบไฟล์สำหรับ action | ตรวจสอบว่า path_action ตรงกับรายการที่รองรับ |
Related APIs
- Update Employee Setting - แก้ไขการตั้งค่าพนักงาน
- Delete Employee Setting - ลบการตั้งค่าพนักงาน
- Get Employee Info - ดึงข้อมูลพนักงาน (รวมการตั้งค่า)
Last updated on