Get Adjust Types
ดึงรายการประเภทการขอเพิ่มเวลาทำงานทั้งหมดที่เปิดใช้งานในระบบ
ใช้ API นี้เพื่อดึงรายการประเภทการขอเพิ่มเวลาสำหรับแสดงใน dropdown หรือใช้อ้างอิง code กับชื่อประเภท ค่า code ที่ได้จาก API นี้ใช้เป็น time_adjust_flag_lv เมื่อส่งไปยัง API อื่น
Endpoint
GET /api/v1/open-apis/time-adjust/get-typesRequest Parameters
ไม่มี parameter ที่ต้องส่ง (ต้องการเฉพาะ API Key header)
Response Format
Success Response (HTTP 200)
{
"code": 200,
"message": "สำเร็จ",
"payload": [
{
"default": "Y",
"code": "01",
"name": "ลืมลงเวลา",
"name_en": "Forgot to Check-in"
},
{
"default": "N",
"code": "02",
"name": "เครื่องเสีย",
"name_en": "Device Malfunction"
},
{
"default": "N",
"code": "03",
"name": "ทำงานนอกสถานที่",
"name_en": "Work Off-site"
},
{
"default": "N",
"code": "04",
"name": "อื่นๆ",
"name_en": "Other"
}
]
}Response Fields
| Field | Type | Nullable | Description |
|---|---|---|---|
default | string | No | ค่า default (Y/N) — ใช้สำหรับเลือกค่าเริ่มต้นในฟอร์ม |
code | string | No | รหัสประเภทเอกสาร — ใช้เป็นค่า time_adjust_flag_lv เมื่อส่งไปยัง API อื่น |
name | string | No | ชื่อประเภทเอกสาร (ภาษาไทย) |
name_en | string | No | ชื่อประเภทเอกสาร (ภาษาอังกฤษ) |
Code Examples
cURL
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/time-adjust/get-types" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"Error Handling
| Error | Cause | Solution |
|---|---|---|
| 401 Unauthorized | API Key ไม่ถูกต้องหรือหมดอายุ | ตรวจสอบ Ocp-Apim-Subscription-Key header |
| 422 Validation Failed | ข้อมูลไม่ถูกต้อง | ตรวจสอบ request ที่ส่ง |
| 500 System Error | เกิดข้อผิดพลาดภายในระบบ | ลองใหม่อีกครั้ง หากยังไม่สำเร็จโปรดติดต่อทีมสนับสนุน |
Notes
- รายการประเภทการขอเพิ่มเวลาที่แสดงขึ้นอยู่กับการตั้งค่าของแต่ละองค์กร
- บางองค์กรอาจเปิดใช้เฉพาะบางประเภทเท่านั้น
- แนะนำให้ cache ข้อมูลนี้เพื่อลดการเรียก API ซ้ำ
Use Cases
- แสดง Dropdown - ใช้แสดงตัวเลือกประเภทการขอเพิ่มเวลาในฟอร์มยื่นคำขอ
- ตั้งค่าเริ่มต้น - ใช้ฟิลด์
defaultเพื่อเลือกค่าเริ่มต้นในฟอร์มอัตโนมัติ - แปลง Code เป็นชื่อ - ใช้แปลง code เช่น
01เป็น “ลืมลงเวลา” - Multi-language Support - ใช้
nameหรือname_enตามภาษาที่ต้องการ
การใช้งานร่วมกับ API อื่น
ฟิลด์ code ที่ได้จาก API นี้ใช้เป็นค่า time_adjust_flag_lv เมื่อส่งไปยัง API อื่น เช่น:
{
"employee_code": "EMP001",
"time_adjust_flag_lv": "01",
"time_adjust_dt": "2026-01-15"
}Related APIs
- Submit Adjust - ยื่นเอกสารขอเพิ่มเวลา (ใช้
codeเป็นtime_adjust_flag_lv) - Update Adjust - แก้ไขเอกสารขอเพิ่มเวลา
- Get Adjust List - ดึงรายการเอกสารขอเพิ่มเวลา
Last updated on