Get Adjust Detail
ดึงรายละเอียดเอกสารขอเพิ่มเวลาทำงานรายการเดียว โดยระบุ time_adjust_id ของเอกสารที่ต้องการ
ใช้ API นี้เพื่อแสดงรายละเอียดเอกสาร ตรวจสอบข้อมูลก่อนอนุมัติ/แก้ไข หรือตรวจสอบสถานะการอนุมัติ สามารถส่ง authorize_line เพื่อตรวจสอบว่าผู้ใช้ปัจจุบันมีสิทธิ์อนุมัติเอกสารนี้หรือไม่
Endpoint
GET /api/v1/open-apis/time-adjust/get-detailRequest Parameters
Required Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
time_adjust_id | string | Yes | รหัสเอกสาร (base64) |
Optional Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
authorize_line | string | "false" | ตรวจสอบสายการอนุมัติ ("true" / "false") |
Response Format
Success Response (HTTP 200)
{
"code": 200,
"message": "สำเร็จ",
"payload": {
"time_adjust_id": "20260225BF89285583CF",
"employee_id": "20260121FC89F3BB9120",
"employee_code": "EMP001",
"employee_name": "ธารวิน",
"employee_last_name": "ศศิพฤกษ์กุล",
"employee_nickname": "วิน",
"employee_name_en": "Tharawin",
"employee_last_name_en": "Sasiprukkun",
"photograph": "images/userPlaceHolder.png",
"time_adjust_dt": "2026-02-25",
"time_adjust_flag_lv": "01",
"flag_name": "ลืมลงเวลา",
"flag_name_en": "Forget to enter time",
"time_adjust_desc": "ลืมรูดบัตรเข้างาน",
"header": "ธารวิน ศศิพฤกษ์กุล (วิน) ยื่นขอ \"ลืมลงเวลา\"",
"detail": "ขอวันที่ 25/02/2026 เวลา 08:00,17:00\nหมายเหตุ : ลืมรูดบัตรเข้างาน\n",
"approve_flag": "01",
"approve_flag_name": "รออนุมัติ",
"approve_by": "สมหญิง มากมาย",
"approve_remark": null,
"read_only_flag": "N",
"authorize_flag": true,
"company_name": "บริษัท ABC",
"branch_name": "สำนักงานใหญ่",
"department_name": "แผนกขาย",
"position_name": "พนักงาน",
"day_status": "วันทำงาน",
"work_cycle_code": "WC002",
"work_cycle_time": "09:00 - 12:00 - 13:00 - 18:00",
"time": [
{ "type": "new", "value": "2026-02-25 08:00:00" },
{ "type": "new", "value": "2026-02-25 17:00:00" }
],
"created": "2026-02-25 11:36:06",
"created_format": "25/02/2026 11:36"
}
}Response Fields
Document Info
| Field | Type | Nullable | Description |
|---|---|---|---|
time_adjust_id | string | No | รหัสเอกสาร |
time_adjust_dt | string | No | วันที่เอกสาร (รูปแบบ YYYY-MM-DD) |
time_adjust_flag_lv | string | No | รหัสประเภทเหตุผล (01-06) |
flag_name | string | No | ชื่อประเภทเหตุผล (ภาษาไทย) |
flag_name_en | string | No | ชื่อประเภทเหตุผล (ภาษาอังกฤษ) |
time_adjust_desc | string | Yes | คำอธิบายเพิ่มเติม |
time_adjust_path | string | Yes | URL รูปภาพแนบ (ถ้ามี) |
header | string | No | หัวข้อเอกสาร |
detail | string | No | รายละเอียดเอกสาร |
Approval Info
| Field | Type | Nullable | Description |
|---|---|---|---|
approve_flag | string | No | รหัสสถานะการอนุมัติ (ดูรหัสได้ที่ Overview) |
approve_flag_name | string | No | ชื่อสถานะการอนุมัติ |
approve_by | string | Yes | ชื่อผู้อนุมัติ |
approve_remark | string | Yes | หมายเหตุจากผู้อนุมัติ |
read_only_flag | string | No | เอกสารห้ามแก้ไข (Y) หรือแก้ไขได้ (N) |
authorize_flag | boolean | No | ผู้ใช้ปัจจุบันมีสิทธิ์อนุมัติหรือไม่ (ต้องส่ง authorize_line=true) |
Employee Info
| Field | Type | Nullable | Description |
|---|---|---|---|
employee_id | string | No | รหัสพนักงาน |
employee_code | string | No | รหัสพนักงาน (รหัสประจำตัว) |
employee_name | string | No | ชื่อพนักงาน (ภาษาไทย) |
employee_last_name | string | No | นามสกุลพนักงาน (ภาษาไทย) |
employee_nickname | string | Yes | ชื่อเล่น (ภาษาไทย) |
employee_name_en | string | Yes | ชื่อพนักงาน (ภาษาอังกฤษ) |
employee_last_name_en | string | Yes | นามสกุล (ภาษาอังกฤษ) |
photograph | string | Yes | รูปภาพโปรไฟล์ |
Organization Info
| Field | Type | Nullable | Description |
|---|---|---|---|
company_name | string | No | ชื่อบริษัท |
branch_name | string | Yes | ชื่อสาขา |
department_name | string | Yes | ชื่อแผนก |
division_name | string | Yes | ชื่อส่วนงาน |
section_name | string | Yes | ชื่อฝ่าย |
position_name | string | Yes | ชื่อตำแหน่ง |
Work & Time Info
| Field | Type | Nullable | Description |
|---|---|---|---|
day_status | string | No | ประเภทวัน (เช่น วันทำงาน, วันหยุด) |
work_cycle_code | string | No | รหัสกะการทำงาน |
work_cycle_time | string | No | คาบเวลาทำงาน (เช่น 09:00 - 12:00 - 13:00 - 18:00) |
time | array | No | รายการเวลาเดิมและเวลาใหม่ |
created | string | No | วันเวลาที่สร้างเอกสาร (รูปแบบ YYYY-MM-DD HH:mm:ss) |
created_format | string | No | วันเวลาที่สร้างเอกสาร (แสดงผล เช่น 25/02/2026 11:36) |
time Object Elements
| Field | Type | Nullable | Description |
|---|---|---|---|
type | string | No | old = เวลาเดิม, new = เวลาใหม่ที่ขอปรับ |
value | string | No | ค่าเวลา (รูปแบบ YYYY-MM-DD HH:mm:ss) |
Code Examples
cURL
# ดึงรายละเอียดเอกสาร
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/time-adjust/get-detail?time_adjust_id=20260225BF89285583CF" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"
# ดึงรายละเอียดพร้อมตรวจสอบสิทธิ์อนุมัติ
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/time-adjust/get-detail?time_adjust_id=20260225BF89285583CF&authorize_line=true" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"Error Handling
| Error | Cause | Solution |
|---|---|---|
| 401 Unauthorized | API Key ไม่ถูกต้องหรือหมดอายุ | ตรวจสอบ Ocp-Apim-Subscription-Key header |
| 404 Not Found | ไม่พบเอกสารตาม time_adjust_id ที่ระบุ | ตรวจสอบ time_adjust_id ว่าถูกต้อง |
| 422 Validation Failed | ข้อมูลไม่ถูกต้อง เช่น ไม่ส่ง time_adjust_id | ตรวจสอบ required parameters |
| 500 System Error | เกิดข้อผิดพลาดภายในระบบ | ลองใหม่อีกครั้ง หากยังไม่สำเร็จโปรดติดต่อทีมสนับสนุน |
Notes
- ค่า
time_adjust_idได้จาก API Get Adjust List หรือจาก response ของ Submit Adjust - หากต้องการตรวจสอบสิทธิ์อนุมัติ ต้องส่ง
authorize_line=trueมิฉะนั้นauthorize_flagจะเป็นfalseเสมอ - ฟิลด์
read_only_flagใช้ตรวจสอบว่าเอกสารสามารถแก้ไขได้หรือไม่ ก่อนเรียก API Update Adjust
Use Cases
- แสดงรายละเอียดเอกสาร - ใช้แสดงข้อมูลครบถ้วนของเอกสารขอเพิ่มเวลา เช่น ประเภทเหตุผล, รายการเวลา, สถานะการอนุมัติ
- ตรวจสอบก่อนอนุมัติ - ผู้อนุมัติดูรายละเอียดเอกสารก่อนตัดสินใจอนุมัติหรือปฏิเสธ โดยส่ง
authorize_line=trueเพื่อตรวจสอบสิทธิ์ - ตรวจสอบสถานะ - ใช้ฟิลด์
approve_flagและapprove_flag_nameเพื่อแสดงสถานะการอนุมัติปัจจุบัน - ตรวจสอบก่อนแก้ไข - ตรวจสอบ
read_only_flagว่าเอกสารยังแก้ไขได้หรือไม่ ก่อนเรียก API แก้ไข
Related APIs
- Get Adjust List - ดึงรายการเอกสารขอเพิ่มเวลา (ใช้เพื่อหา
time_adjust_id) - Update Adjust - แก้ไขเอกสารขอเพิ่มเวลา
- Approve Adjust - อนุมัติหรือปฏิเสธเอกสาร
- Delete Adjust - ลบเอกสารขอเพิ่มเวลา
Last updated on