Get Organization Structure

ดึงโครงสร้างองค์กรแบบลำดับชั้น (Hierarchical Tree) ที่ครอบคลุมทุกระดับของโครงสร้างองค์กร ตั้งแต่บริษัท (Company) ลงไปถึงหน่วยงานย่อยระดับ 5 (Section Level 5)

API นี้สร้างโครงสร้างแบบ Tree Structure ที่แสดงความสัมพันธ์ระหว่างหน่วยงานทุกระดับ รองรับโครงสร้างองค์กรที่ซับซ้อนได้สูงสุด 10 ระดับ

Endpoint


GET /api/v1/open-apis/organization/get-list-organization

Organization Structure Hierarchy

โครงสร้างองค์กรมี 10 ระดับ:

Company - บริษัท
Branch - สำนักงานสาขา
Department - แผนก
Division - ฝ่ายงาน
Section - หน่วยงาน
Section Level 1 - หน่วยงานย่อยระดับ 1
Section Level 2 - หน่วยงานย่อยระดับ 2
Section Level 3 - หน่วยงานย่อยระดับ 3
Section Level 4 - หน่วยงานย่อยระดับ 4
Section Level 5 - หน่วยงานย่อยระดับ 5

Request Parameters

ไม่มี parameters

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": [
    {
      "id": "ORG001",
      "code": "COM-A",
      "name": "บริษัท ก จำกัด",
      "name_th": "บริษัท ก จำกัด",
      "name_en": "Company A Co., Ltd.",
      "level_name": "บริษัท",
      "level_name_en": "Company",
      "children": [
        {
          "id": "BRN001",
          "code": "HQ",
          "name": "สำนักงานใหญ่",
          "name_th": "สำนักงานใหญ่",
          "name_en": "Head Office",
          "level_name": "สำนักงานสาขา",
          "level_name_en": "Branch",
          "children": [
            {
              "id": "DEP001",
              "code": "HR",
              "name": "ฝ่ายทรัพยากรบุคคล",
              "name_th": "ฝ่ายทรัพยากรบุคคล",
              "name_en": "Human Resources",
              "level_name": "แผนก",
              "level_name_en": "Department"
            },
            {
              "id": "DEP002",
              "code": "ACC",
              "name": "ฝ่ายบัญชี",
              "name_th": "ฝ่ายบัญชี",
              "name_en": "Accounting",
              "level_name": "แผนก",
              "level_name_en": "Department"
            }
          ]
        },
        {
          "id": "BRN002",
          "code": "BRN-01",
          "name": "สาขา 1",
          "name_th": "สาขา 1",
          "name_en": "Branch 1",
          "level_name": "สำนักงานสาขา",
          "level_name_en": "Branch",
          "children": [
            {
              "id": "DEP003",
              "code": "SALES",
              "name": "ฝ่ายขาย",
              "name_th": "ฝ่ายขาย",
              "name_en": "Sales",
              "level_name": "แผนก",
              "level_name_en": "Department"
            }
          ]
        }
      ]
    }
  ]
}

Error Response (HTTP 400)


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "error": "Error message here"
}

Response Fields

แต่ละระดับของโครงสร้างองค์กรมี fields ดังนี้:

Field	Type	Description
`id`	string	รหัสหน่วยงานในระบบ
`code`	string	รหัสหน่วยงาน
`name`	string	ชื่อหน่วยงาน (แสดงตามภาษาที่เลือก)
`name_th`	string	ชื่อหน่วยงานภาษาไทย
`name_en`	string	ชื่อหน่วยงานภาษาอังกฤษ
`level_name`	string	ชื่อระดับองค์กร (ภาษาไทย)
`level_name_en`	string	ชื่อระดับองค์กร (ภาษาอังกฤษ)
`children`	array	หน่วยงานลูกในระดับถัดไป

Customizable Level Names

ระบบรองรับการกำหนดชื่อระดับองค์กรเอง (Custom Naming) ผ่านระบบ Config โดยมี default values ดังนี้:

Level	Default TH	Default EN
Company	บริษัท	Company
Branch	สำนักงานสาขา	Branch
Department	แผนก	Department
Division	ฝ่ายงาน	Division
Section	หน่วยงาน	Section
Section Level 1	หน่วยงานย่อยระดับ 1	Section level 1
Section Level 2	หน่วยงานย่อยระดับ 2	Section level 2
Section Level 3	หน่วยงานย่อยระดับ 3	Section level 3
Section Level 4	หน่วยงานย่อยระดับ 4	Section level 4
Section Level 5	หน่วยงานย่อยระดับ 5	Section level 5

Code Examples

cURL


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

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/organization/get-list-organization',
  {
    method: 'GET',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    }
  }
)
const data = await response.json()
console.log(data.payload)

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/organization/get-list-organization"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY"
}
 
response = requests.get(url, headers=headers)
data = response.json()
print(data['payload'])

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/organization/get-list-organization";
 
$headers = [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY",
];
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
$data = json_decode($response, true);
 
print_r($data['payload']);
curl_close($ch);
?>

Notes

ถ้าไม่มีโครงสร้างองค์กรในระบบ API จะส่ง error response กลับมา
ฟิลด์ name จะแสดงตามภาษาที่เลือก (TH หรือ EN)

Performance

ข้อมูลจะถูกจัดเป็นโครงสร้างแบบ Tree Structure โดยอัตโนมัติ
รองรับโครงสร้างองค์กรที่ซับซ้อนได้สูงสุด 10 ระดับ
ควรใช้ Cache สำหรับข้อมูลนี้เนื่องจากไม่ค่อยเปลี่ยนแปลงบ่อย

Get Position List - ดึงรายการตำแหน่งงาน
Get Bank List - ดึงรายการธนาคาร