Update Employee Profile

Router สำหรับแก้ไขข้อมูลส่วนตัวพนักงาน รองรับการเรียกใช้งานแบบแยกเรื่องผ่าน path_action parameter

API นี้ใช้ Router Pattern - ระบุ path_action เพื่อเลือกประเภท Profile ที่ต้องการแก้ไข

Endpoint


POST /api/v1/open-apis/employee/update-employee-profile

Query Parameters

Parameter	Type	Required	Description
`path_action`	string	Yes	ประเภทข้อมูลที่ต้องการแก้ไข

Base Parameters

Parameter	Type	Required	Description
`employee_code`	string	Yes	รหัสพนักงาน

ใช้ employee_code เพื่อระบุพนักงาน

พารามิเตอร์ที่ลงท้ายด้วย _id ต้องส่งเป็น Base64-encoded ของ raw internal ID

Response จะ return raw string ID (เช่น 20260121FC89F3BB9120)
เมื่อนำ ID จาก response ไปใช้ใน request ถัดไป ต้อง encode เป็น Base64 ก่อน

Supported Actions

path_action	Description	Required ID
`family`	แก้ไขข้อมูลครอบครัว	employee_family_id
`work`	แก้ไขประวัติการทำงาน	employee_work_id
`education`	แก้ไขประวัติการศึกษา	employee_education_id
`ability`	แก้ไขความสามารถพิเศษ	employee_ability_id
`language-skill`	แก้ไขทักษะภาษา	employee_language_skill_id
`typing-skill`	แก้ไขทักษะพิมพ์ดีด	employee_typing_skill_id
`driving-skill`	แก้ไขทักษะการขับขี่	employee_driving_skill_id
`training`	แก้ไขประวัติการฝึกอบรม	employee_training_id
`possess`	แก้ไขทรัพย์สินครอบครอง	employee_possess_id
`hospital`	แก้ไขโรงพยาบาลตามสิทธิ	employee_hospital_id
`document`	แก้ไขเอกสาร	employee_documents_id
`address`	แก้ไขที่อยู่	employee_id

Action Details

family - แก้ไขข้อมูลครอบครัว

Parameter	Type	Required	Description
`employee_family_id`	string	Yes	ID ของข้อมูลครอบครัว
`relation_type`	string	No	ประเภทความสัมพันธ์
`family_name`	string	No	ชื่อ
`family_last_name`	string	No	นามสกุล
`family_birthday`	string	No	วันเกิด

education - แก้ไขประวัติการศึกษา

Parameter	Type	Required	Description
`employee_education_id`	string	Yes	ID ของประวัติการศึกษา
`education_level`	string	No	ระดับการศึกษา
`education_place`	string	No	สถาบันการศึกษา
`education_major`	string	No	สาขาวิชา
`education_year`	string	No	ปีที่จบ

work - แก้ไขประวัติการทำงาน

Parameter	Type	Required	Description
`employee_work_id`	string	Yes	ID ของประวัติการทำงาน
`work_company`	string	No	ชื่อบริษัท
`work_position`	string	No	ตำแหน่ง
`work_date_from`	string	No	วันที่เริ่ม
`work_date_to`	string	No	วันที่สิ้นสุด

address - แก้ไขที่อยู่

Parameter	Type	Required	Description
`employee_id`	string	Yes	ID ของพนักงาน (Base64)
`address`	string	No	ที่อยู่ทะเบียนบ้าน
`country_code`	string	No	รหัสประเทศ
`state_code`	string	No	รหัสจังหวัด
`district_code`	string	No	รหัสอำเภอ/เขต
`subdistrict_code`	string	No	รหัสตำบล/แขวง
`post_code`	string	No	รหัสไปรษณีย์
`current_address`	string	No	ที่อยู่ปัจจุบัน
`current_country_code`	string	No	รหัสประเทศปัจจุบัน
`current_state_code`	string	No	รหัสจังหวัดปัจจุบัน
`current_district_code`	string	No	รหัสอำเภอ/เขตปัจจุบัน
`current_subdistrict_code`	string	No	รหัสตำบล/แขวงปัจจุบัน
`current_post_code`	string	No	รหัสไปรษณีย์ปัจจุบัน

Action address ใช้ employee_code ใน query parameter และ employee_id (Base64) ใน request body

document - แก้ไขเอกสาร

ต้องใช้ Content-Type: multipart/form-data สำหรับการ upload เอกสาร

Parameter	Type	Required	Description
`employee_documents_id`	string	Yes	ID ของเอกสาร
`documents_name`	string	No	ชื่อเอกสาร
`documents_expired`	string	No	วันหมดอายุ
`_doc`	file	No	ไฟล์เอกสารใหม่

Response Format

Success Response


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": {
    // ข้อมูลที่แก้ไขสำเร็จ
  }
}

Error Response


{
  "code": 400,
  "message": "ข้อมูลไม่ถูกต้อง",
  "errors": [
    "กรุณาระบุ 'employee_family_id'"
  ]
}

Code Examples

cURL


# แก้ไขข้อมูลครอบครัว
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-profile?path_action=family" \
  -H "Content-Type: application/json" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -d '{
    "employee_code": "EMP001",
    "employee_family_id": "MjAyNjAxMjFGTTAxQjJDM0Q0RTU=",
    "family_name": "สมชาย",
    "family_last_name": "ใจดี"
  }'
 
# แก้ไขประวัติการศึกษา
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-profile?path_action=education" \
  -H "Content-Type: application/json" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -d '{
    "employee_code": "EMP001",
    "employee_education_id": "MjAyNjAxMjFFRDAxQTJCM0M0RDU=",
    "education_place": "มหาวิทยาลัยเกษตรศาสตร์",
    "education_major": "วิทยาการคอมพิวเตอร์"
  }'
 
# แก้ไขที่อยู่
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-profile?path_action=address&employee_code=EMP001" \
  -H "Content-Type: application/json" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -d '{
    "employee_id": "MjAyNjAxMjFGQzg5RjNCQjkxMjA=",
    "address": "99/1 ถนนนเรศวร",
    "state_code": "65",
    "district_code": "6501"
  }'

JavaScript


async function updateEmployeeProfile(pathAction, data) {
  const response = await fetch(
    `https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-profile?path_action=${pathAction}`,
    {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
      },
      body: JSON.stringify(data)
    }
  )
  return response.json()
}
 
// แก้ไขข้อมูลครอบครัว
await updateEmployeeProfile('family', {
  employee_code: 'EMP001',
  employee_family_id: 'MjAyNjAxMjFGTTAxQjJDM0Q0RTU=',
  family_name: 'สมชาย',
  family_last_name: 'ใจดี'
})
 
// แก้ไขประวัติการศึกษา
await updateEmployeeProfile('education', {
  employee_code: 'EMP001',
  employee_education_id: 'MjAyNjAxMjFFRDAxQTJCM0M0RDU=',
  education_place: 'มหาวิทยาลัยเกษตรศาสตร์'
})
 
// แก้ไขที่อยู่
await updateEmployeeProfile('address', {
  employee_code: 'EMP001',
  employee_id: 'MjAyNjAxMjFGQzg5RjNCQjkxMjA=',
  address: '99/1 ถนนนเรศวร',
  state_code: '65'
})

Python


import requests
 
def update_employee_profile(path_action: str, data: dict):
    url = "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-profile"
    headers = {
        "Content-Type": "application/json",
        "Ocp-Apim-Subscription-Key": "YOUR_API_KEY"
    }
    params = {"path_action": path_action}
 
    response = requests.post(url, headers=headers, params=params, json=data)
    return response.json()
 
# แก้ไขข้อมูลครอบครัว
update_employee_profile("family", {
    "employee_code": "EMP001",
    "employee_family_id": "MjAyNjAxMjFGTTAxQjJDM0Q0RTU=",
    "family_name": "สมชาย"
})
 
# แก้ไขประวัติการศึกษา
update_employee_profile("education", {
    "employee_code": "EMP001",
    "employee_education_id": "MjAyNjAxMjFFRDAxQTJCM0M0RDU=",
    "education_place": "มหาวิทยาลัยเกษตรศาสตร์"
})
 
# แก้ไขที่อยู่
update_employee_profile("address", {
    "employee_code": "EMP001",
    "employee_id": "MjAyNjAxMjFGQzg5RjNCQjkxMjA=",
    "address": "99/1 ถนนนเรศวร"
})

PHP


<?php
function updateEmployeeProfile($pathAction, $data) {
    $url = "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-profile?path_action=" . $pathAction;
 
    $headers = [
        "Content-Type: application/json",
        "Ocp-Apim-Subscription-Key: YOUR_API_KEY"
    ];
 
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
    curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
    $response = curl_exec($ch);
    curl_close($ch);
 
    return json_decode($response, true);
}
 
// แก้ไขข้อมูลครอบครัว
updateEmployeeProfile("family", [
    "employee_code" => "EMP001",
    "employee_family_id" => "MjAyNjAxMjFGTTAxQjJDM0Q0RTU=",
    "family_name" => "สมชาย"
]);
 
// แก้ไขประวัติการศึกษา
updateEmployeeProfile("education", [
    "employee_code" => "EMP001",
    "employee_education_id" => "MjAyNjAxMjFFRDAxQTJCM0M0RDU=",
    "education_place" => "มหาวิทยาลัยเกษตรศาสตร์"
]);
?>

Troubleshooting

Error	Solution
กรุณาระบุ ‘path_action’	ต้องระบุ path_action ใน query parameter
กรุณาระบุ ‘employee_xxx_id’	ต้องระบุ ID ของข้อมูลที่ต้องการแก้ไข
ไม่พบไฟล์สำหรับ action	ตรวจสอบว่า path_action ตรงกับรายการที่รองรับ

Add Employee Profile - เพิ่มข้อมูล Profile
Delete Employee Profile - ลบข้อมูล Profile
Get Employee Info - ดึงข้อมูลพนักงาน