Get Position List

ดึงรายการตำแหน่งงาน (Position) โดยสามารถดึงตำแหน่งทั้งหมด หรือดึงตำแหน่งที่อยู่ภายใต้ตำแหน่งหลัก (Parent Position) ที่ระบุได้

API รองรับโครงสร้างตำแหน่งแบบลำดับชั้น (Hierarchical Structure) เหมาะสำหรับการแสดงผล Organization Chart

Endpoint


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

สิทธิ์ที่ต้องการ: API Key ต้องมีสิทธิ์ กลุ่มข้อมูลองค์กร (org:manage)

Request Parameters

Parameter	Type	Required	Description
`parent_position_id`	string	No	รหัสตำแหน่งหลัก (ถ้าไม่ระบุจะดึงตำแหน่งหลักทั้งหมด)

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": [
    {
      "position_id": "20260119ACBC37B04440",
      "parent_position_id": "0",
      "position_level": "1",
      "position_code": "POS00001",
      "position_name": "ผู้บริหาร",
      "position_name_en": "Executive",
      "position_desc": null,
      "position_desc_en": null,
      "position_max_salary": "0.00",
      "position_step_approve": "2",
      "position_level_code": "a",
      "position_job_desc": null,
      "position_job_desc_en": null,
      "position_job_spec": null,
      "position_job_spec_en": null,
      "order_no": "1",
      "position_level_name": "L1",
      "employee_count": "0",
      "childs": []
    }
  ]
}

Error Response (HTTP 400)

Validation Error


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "errors": [
    "'parent_position_id' must be a string"
  ]
}

Exception Error


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

Response Fields

Field	Type	Description
`position_id`	string	รหัสตำแหน่งในระบบ
`parent_position_id`	string	รหัสตำแหน่งหลัก (`"0"` = ตำแหน่งระดับบนสุด)
`position_level`	string	ระดับของตำแหน่ง (1, 2, 3, …)
`position_code`	string	รหัสตำแหน่ง
`position_name`	string	ชื่อตำแหน่งภาษาไทย
`position_name_en`	string	ชื่อตำแหน่งภาษาอังกฤษ
`position_desc`	string\|null	คำอธิบายตำแหน่งภาษาไทย
`position_desc_en`	string\|null	คำอธิบายตำแหน่งภาษาอังกฤษ
`position_max_salary`	string	เงินเดือนสูงสุดของตำแหน่ง
`position_step_approve`	string	จำนวนขั้นตอนการอนุมัติ
`position_level_code`	string\|null	รหัสระดับตำแหน่ง
`position_job_desc`	string\|null	Job Description ภาษาไทย
`position_job_desc_en`	string\|null	Job Description ภาษาอังกฤษ
`position_job_spec`	string\|null	Job Specification ภาษาไทย
`position_job_spec_en`	string\|null	Job Specification ภาษาอังกฤษ
`order_no`	string	ลำดับการแสดงผล
`position_level_name`	string	ชื่อระดับตำแหน่ง (เช่น `"L1"`, `"L2"`)
`employee_count`	string	จำนวนพนักงานในตำแหน่ง
`childs`	array	รายการตำแหน่งย่อย (recursive structure เดียวกับ parent)

Usage Examples

ดึงตำแหน่งหลักทั้งหมด (Root Positions)

cURL


# ไม่ระบุ parameter
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/organization/get-list-position" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"
 
# หรือระบุ parent_position_id=0
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/organization/get-list-position?parent_position_id=0" \
  -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-position',
  {
    headers: { 'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY' }
  }
)
const data = await response.json()

Python


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

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/organization/get-list-position";
 
$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);
$positions = $data['payload'];
curl_close($ch);
?>

ดึงตำแหน่งย่อยภายใต้ตำแหน่งหลัก

cURL


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

JavaScript


const parentId = '20260119ACBC37B04440'
const response = await fetch(
  `https://openapi.humansoft.co.th/api/v1/open-apis/organization/get-list-position?parent_position_id=${parentId}`,
  {
    headers: { 'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY' }
  }
)
const data = await response.json()

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/organization/get-list-position"
headers = {"Ocp-Apim-Subscription-Key": "YOUR_API_KEY"}
params = {"parent_position_id": "20260119ACBC37B04440"}
 
response = requests.get(url, params=params, headers=headers)
data = response.json()

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/organization/get-list-position?parent_position_id=20260119ACBC37B04440";
 
$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);
$positions = $data['payload'];
curl_close($ch);
?>

Notes

ถ้าไม่ระบุ parent_position_id จะดึงตำแหน่งระดับบนสุด (parent_position_id = "0")
ถ้าไม่มีข้อมูล payload จะเป็น array ว่าง []

Get Organization Structure - ดึงโครงสร้างองค์กร
Add Employee - เพิ่มพนักงานพร้อมกำหนดตำแหน่ง

Get Position List

Endpoint

Request Parameters

Response Format

Success Response (HTTP 200)

Error Response (HTTP 400)

Validation Error

Exception Error

Response Fields

Usage Examples

ดึงตำแหน่งหลักทั้งหมด (Root Positions)

cURL

JavaScript

Python

PHP

ดึงตำแหน่งย่อยภายใต้ตำแหน่งหลัก

cURL

JavaScript

Python

PHP

Notes

Related APIs