Get Position List
ดึงรายการตำแหน่งงาน (Position) โดยสามารถดึงตำแหน่งทั้งหมด หรือดึงตำแหน่งที่อยู่ภายใต้ตำแหน่งหลัก (Parent Position) ที่ระบุได้
API รองรับโครงสร้างตำแหน่งแบบลำดับชั้น (Hierarchical Structure) เหมาะสำหรับการแสดงผล Organization Chart
Endpoint
GET /api/v1/open-apis/organization/get-list-positionRequest Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
parent_position_id | string | No | รหัสตำแหน่งหลัก (ถ้าไม่ระบุจะดึงตำแหน่งหลักทั้งหมด) |
Response Format
Success Response (HTTP 200)
{
"code": 200,
"message": "สำเร็จ",
"payload": [
{
"position_id": "1",
"position_code": "POS001",
"position_name": "ผู้จัดการทั่วไป",
"position_name_en": "General Manager",
"parent_position_id": "0",
"level": "1"
}
]
}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 | รหัสตำแหน่งในระบบ |
position_code | string | รหัสตำแหน่ง |
position_name | string | ชื่อตำแหน่งภาษาไทย |
position_name_en | string | ชื่อตำแหน่งภาษาอังกฤษ |
parent_position_id | string | รหัสตำแหน่งหลัก (0 = ตำแหน่งระดับบนสุด) |
level | string | ระดับของตำแหน่ง |
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"ดึงตำแหน่งย่อยภายใต้ตำแหน่งหลัก
cURL
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/organization/get-list-position?parent_position_id=1" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"Notes
- ถ้าไม่ระบุ
parent_position_idจะดึงตำแหน่งระดับบนสุด (parent_position_id = 0) - มีการ validate parameters ก่อนประมวลผล
- ถ้าไม่มีข้อมูล payload จะเป็น array ว่าง
[]
Related APIs
- Get Organization Structure - ดึงโครงสร้างองค์กร
- Add Employee - เพิ่มพนักงานพร้อมกำหนดตำแหน่ง
Last updated on