Get Work Cycle Types

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

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

Endpoint


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

Request Parameters

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

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": [
    {
      "code": "A",
      "name": "A : 08:00-17:00",
      "work_cycle_id": "V0MwMDE=",
      "work_cycle_type": "00",
      "work_start_time": "08:00",
      "work_end_time": "17:00",
      "break_start_time": "12:00",
      "break_end_time": "13:00",
      "work_hour": "08:00:00",
      "break_hour": "01:00:00",
      "work_cycle_auto": "N",
      "text_color": "#FFFFFF",
      "background_color": "#1976D2"
    },
    {
      "code": "B",
      "name": "B : 13:00-22:00",
      "work_cycle_id": "V0MwMDI=",
      "work_cycle_type": "00",
      "work_start_time": "13:00",
      "work_end_time": "22:00",
      "break_start_time": "17:00",
      "break_end_time": "18:00",
      "work_hour": "08:00:00",
      "break_hour": "01:00:00",
      "work_cycle_auto": "N",
      "text_color": "#FFFFFF",
      "background_color": "#388E3C"
    }
  ]
}

Error Response (HTTP 400)


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "error": "Missing required authentication parameters"
}

Response Fields

Field	Type	Description
`code`	string	รหัสกะการทำงาน
`name`	string	ชื่อกะ (รูปแบบ: รหัส : เวลาเริ่ม-เวลาสิ้นสุด)
`work_cycle_id`	string	ID ของกะการทำงาน (Base64)
`work_cycle_type`	string	ประเภทกะ (`00` = ปกติ, `04` = กะคู่)
`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	กะอัตโนมัติ (Y/N)
`text_color`	string	สีตัวอักษร (Hex color)
`background_color`	string	สีพื้นหลัง (Hex color)

Dual Shift (work_cycle_type = 04)

สำหรับกะคู่จะมี field เพิ่มเติม:

Field	Type	Description
`merge_1_work_start_time`	string	เวลาเริ่มทำงานช่วงที่ 1
`merge_1_work_end_time`	string	เวลาสิ้นสุดช่วงที่ 1
`merge_1_break_start_time`	string	เวลาเริ่มพักช่วงที่ 1
`merge_1_break_end_time`	string	เวลาสิ้นสุดพักช่วงที่ 1
`merge_2_work_start_time`	string	เวลาเริ่มทำงานช่วงที่ 2
`merge_2_work_end_time`	string	เวลาสิ้นสุดช่วงที่ 2
`merge_2_break_start_time`	string	เวลาเริ่มพักช่วงที่ 2
`merge_2_break_end_time`	string	เวลาสิ้นสุดพักช่วงที่ 2

Code Examples

cURL


curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle/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/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}`)
  })
} else {
  console.error('Error:', data.error)
}

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle/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']}")
else:
    print('Error:', data.get('error'))

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle/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";
    }
} else {
    echo "Error: " . $data['error'];
}
 
curl_close($ch);
?>

ประเภทกะ

Type	Description	ตัวอย่าง
`00`	กะปกติ	08:00-17:00
`04`	กะคู่ (Dual Shift)	เช้า 06:00-10:00, บ่าย 14:00-18:00

Notes

Use Cases

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

Active Cycles Only

API จะดึงเฉพาะกะที่ยังใช้งานอยู่
กะที่ถูกลบไปแล้วจะไม่แสดง

Color Codes

text_color และ background_color จะแสดงเฉพาะเมื่อมีการตั้งค่าไว้
ใช้สำหรับแสดงในปฏิทินหรือ UI

Get Employee Setting - ดูการตั้งค่ากะของพนักงาน
Get Monthly Schedule - ดูตารางกะรายเดือน
Update Employee Setting - แก้ไขการตั้งค่ากะ

Get Work Cycle Types

Endpoint

Request Parameters

Response Format

Success Response (HTTP 200)

Error Response (HTTP 400)

Response Fields

Dual Shift (work_cycle_type = 04)

Code Examples

cURL

JavaScript

Python

PHP

ประเภทกะ

Notes

Use Cases

Active Cycles Only

Color Codes

Related APIs