Get Employee Setting
ดึงการตั้งค่ากะพื้นฐานของพนักงาน
ใช้ API นี้เพื่อดูว่าพนักงานมีการตั้งค่ากะพื้นฐานอย่างไร เช่น กะประจำวันจันทร์-ศุกร์
Endpoint
GET /api/v1/open-apis/work-cycle/get-employee-base-work-cycle-settingRequest Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
employee_code | string | Yes | รหัสพนักงาน | EMP001 |
Response Format
Success Response (HTTP 200)
{
"code": 200,
"message": "สำเร็จ",
"payload": {
"work_cycle_format": "weekly",
"work_cycle_id_json": "{\"monday\":\"1\",\"tuesday\":\"1\",\"wednesday\":\"1\",\"thursday\":\"1\",\"friday\":\"1\",\"saturday\":null,\"sunday\":null}",
"work_cycle_lists": {
"monday": {
"work_cycle_code": "A",
"work_cycle_id": "V0MwMDE="
},
"tuesday": {
"work_cycle_code": "A",
"work_cycle_id": "V0MwMDE="
},
"wednesday": {
"work_cycle_code": "A",
"work_cycle_id": "V0MwMDE="
},
"thursday": {
"work_cycle_code": "A",
"work_cycle_id": "V0MwMDE="
},
"friday": {
"work_cycle_code": "A",
"work_cycle_id": "V0MwMDE="
},
"saturday": {
"work_cycle_code": null,
"work_cycle_id": null
},
"sunday": {
"work_cycle_code": null,
"work_cycle_id": null
}
}
}
}Error Response - Missing Parameter (HTTP 400)
{
"code": 400,
"message": "ไม่สำเร็จ",
"error": "Missing required parameter: employee_code"
}Error Response - Employee Not Found (HTTP 400)
{
"code": 400,
"message": "ไม่สำเร็จ",
"error": "Employee not found with code: EMP999"
}Response Fields
| Field | Type | Description |
|---|---|---|
work_cycle_format | string | รูปแบบกะ (weekly, daily, fixed) |
work_cycle_id_json | string | JSON ของ work_cycle_id แต่ละวัน |
work_cycle_lists | object | รายการกะแต่ละวัน (พร้อมรายละเอียด) |
work_cycle_lists[day]
| Field | Type | Description |
|---|---|---|
work_cycle_code | string | รหัสกะ (เช่น A, B) หรือ null ถ้าหยุด |
work_cycle_id | string | ID ของกะ (Base64) หรือ null ถ้าหยุด |
Code Examples
cURL
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle/get-employee-base-work-cycle-setting?employee_code=EMP001" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"Work Cycle Format
| Format | Description |
|---|---|
weekly | กำหนดกะรายสัปดาห์ (จันทร์-อาทิตย์) |
daily | กำหนดกะรายวัน (กำหนดกะแยกแต่ละวัน) |
Day Keys
| Key | วัน |
|---|---|
monday | วันจันทร์ |
tuesday | วันอังคาร |
wednesday | วันพุธ |
thursday | วันพฤหัสบดี |
friday | วันศุกร์ |
saturday | วันเสาร์ |
sunday | วันอาทิตย์ |
Error Handling
| Error | Cause | Solution |
|---|---|---|
Missing required parameter: employee_code | ไม่ได้ส่ง employee_code | ตรวจสอบ query parameter |
Employee not found with code: XXX | ไม่พบพนักงาน | ตรวจสอบ employee_code |
Notes
Use Cases
- ดูกะพื้นฐานของพนักงาน - ตรวจสอบว่าพนักงานทำกะอะไรในแต่ละวัน
- แสดงฟอร์มแก้ไข - ดึงข้อมูลปัจจุบันก่อนแก้ไข
- ตรวจสอบวันหยุด - ดูว่าวันไหนไม่มีกะ (null)
Null Values
work_cycle_code = nullและwork_cycle_id = nullหมายถึงวันหยุด- พนักงานไม่ต้องเข้างานในวันนั้น
Related APIs
- Get Work Cycle Types - ดูรายการกะทั้งหมด
- Update Employee Setting - แก้ไขการตั้งค่ากะ
- Get Monthly Schedule - ดูตารางกะรายเดือน
Last updated on