Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Get Adjust Types

ดึงรายการประเภทการขอเพิ่มเวลาทำงานทั้งหมดที่เปิดใช้งานในระบบ

ใช้ API นี้เพื่อดึงรายการประเภทการขอเพิ่มเวลาสำหรับแสดงใน dropdown หรือใช้อ้างอิง code กับชื่อประเภท ค่า code ที่ได้จาก API นี้ใช้เป็น time_adjust_flag_lv เมื่อส่งไปยัง API อื่น

Endpoint

GET /api/v1/open-apis/time-adjust/get-types

Request 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

FieldTypeNullableDescription
defaultstringNoค่า default (Y/N) — ใช้สำหรับเลือกค่าเริ่มต้นในฟอร์ม
codestringNoรหัสประเภทเอกสาร — ใช้เป็นค่า time_adjust_flag_lv เมื่อส่งไปยัง API อื่น
namestringNoชื่อประเภทเอกสาร (ภาษาไทย)
name_enstringNoชื่อประเภทเอกสาร (ภาษาอังกฤษ)

Code Examples

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

ErrorCauseSolution
401 UnauthorizedAPI Key ไม่ถูกต้องหรือหมดอายุตรวจสอบ Ocp-Apim-Subscription-Key header
422 Validation Failedข้อมูลไม่ถูกต้องตรวจสอบ request ที่ส่ง
500 System Errorเกิดข้อผิดพลาดภายในระบบลองใหม่อีกครั้ง หากยังไม่สำเร็จโปรดติดต่อทีมสนับสนุน

Notes

  • รายการประเภทการขอเพิ่มเวลาที่แสดงขึ้นอยู่กับการตั้งค่าของแต่ละองค์กร
  • บางองค์กรอาจเปิดใช้เฉพาะบางประเภทเท่านั้น
  • แนะนำให้ cache ข้อมูลนี้เพื่อลดการเรียก API ซ้ำ

Use Cases

  1. แสดง Dropdown - ใช้แสดงตัวเลือกประเภทการขอเพิ่มเวลาในฟอร์มยื่นคำขอ
  2. ตั้งค่าเริ่มต้น - ใช้ฟิลด์ default เพื่อเลือกค่าเริ่มต้นในฟอร์มอัตโนมัติ
  3. แปลง Code เป็นชื่อ - ใช้แปลง code เช่น 01 เป็น “ลืมลงเวลา”
  4. 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" }
  • Submit Adjust - ยื่นเอกสารขอเพิ่มเวลา (ใช้ code เป็น time_adjust_flag_lv)
  • Update Adjust - แก้ไขเอกสารขอเพิ่มเวลา
  • Get Adjust List - ดึงรายการเอกสารขอเพิ่มเวลา
Last updated on