Get Work Cycle Types

ดึงรายการกะการทำงานทั้งหมดในองค์กร

ใช้ API นี้เพื่อดึงรายการกะที่มีในระบบ สำหรับแสดงใน Dropdown เลือกกะที่ต้องการเปลี่ยน

Endpoint


GET /api/v1/open-apis/work-cycle-change/get-types

สิทธิ์ที่ต้องการ: API Key ต้องมีสิทธิ์ ข้อมูลการยื่นเอกสาร (document:manage)

Request Parameters

ไม่มี parameter เพิ่มเติม (ใช้เฉพาะ authentication header)

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": [
    {
      "code": "WC0008",
      "name": "WC0008 : 09:00-18:00",
      "work_cycle_id": "20251127D4573C421639",
      "work_cycle_type": "05",
      "work_start_time": "09:00",
      "work_end_time": "18:00",
      "break_start_time": "12:00",
      "break_end_time": "13:00",
      "work_hour": "00:00:00",
      "break_hour": "00:00:00",
      "work_cycle_auto": "0",
      "text_color": "#008CFF",
      "background_color": "#E6F4FA"
    }
  ]
}

Response Fields

Field	Type	Description
`code`	string	รหัสกะการทำงาน
`name`	string	ชื่อกะ (รูปแบบ: รหัส : เวลาเริ่ม-เวลาสิ้นสุด)
`work_cycle_id`	string	ID ของกะการทำงาน
`work_cycle_type`	string	ประเภทกะการทำงาน
`work_start_time`	string	เวลาเริ่มทำงาน (HH:MM)
`work_end_time`	string	เวลาสิ้นสุดการทำงาน (HH:MM)
`break_start_time`	string	เวลาเริ่มพัก (HH:MM)
`break_end_time`	string	เวลาสิ้นสุดการพัก (HH:MM)
`work_hour`	string	จำนวนชั่วโมงทำงาน (HH:MM:SS)
`break_hour`	string	จำนวนชั่วโมงพัก (HH:MM:SS)
`work_cycle_auto`	string	กะอัตโนมัติ (`0` = ไม่อัตโนมัติ, `1` = อัตโนมัติ)
`text_color`	string	สีตัวอักษร (Hex color)
`background_color`	string	สีพื้นหลัง (Hex color)

Code Examples

cURL


curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle-change/get-types" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle-change/get-types',
  {
    method: 'GET',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    }
  }
)
 
const data = await response.json()
 
if (data.code === 200) {
  data.payload.forEach(cycle => {
    console.log(`${cycle.code}: ${cycle.work_start_time}-${cycle.work_end_time}`)
  })
}

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle-change/get-types"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY"
}
 
response = requests.get(url, headers=headers)
data = response.json()
 
if data['code'] == 200:
    for cycle in data['payload']:
        print(f"{cycle['code']}: {cycle['work_start_time']}-{cycle['work_end_time']}")

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle-change/get-types";
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
$data = json_decode($response, true);
 
if ($data['code'] === 200) {
    foreach ($data['payload'] as $cycle) {
        echo "{$cycle['code']}: {$cycle['work_start_time']}-{$cycle['work_end_time']}\n";
    }
}
 
curl_close($ch);
?>

Notes

Use Cases

แสดง Dropdown เลือกกะ - ดึงรายการกะสำหรับฟอร์มเปลี่ยนกะ
แสดงรายละเอียดกะ - ดูเวลาเข้า-ออกของแต่ละกะ

Submit Change Request - ยื่นคำขอเปลี่ยนกะ
Get Change List - ดูรายการคำขอเปลี่ยนกะ