Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Get Position List

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

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

Endpoint

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

Request Parameters

ParameterTypeRequiredDescription
parent_position_idstringNoรหัสตำแหน่งหลัก (ถ้าไม่ระบุจะดึงตำแหน่งหลักทั้งหมด)

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

FieldTypeDescription
position_idstringรหัสตำแหน่งในระบบ
position_codestringรหัสตำแหน่ง
position_namestringชื่อตำแหน่งภาษาไทย
position_name_enstringชื่อตำแหน่งภาษาอังกฤษ
parent_position_idstringรหัสตำแหน่งหลัก (0 = ตำแหน่งระดับบนสุด)
levelstringระดับของตำแหน่ง

Usage Examples

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

# ไม่ระบุ 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 -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 ว่าง []
Last updated on