Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Add Employee Language Skill

เพิ่มทักษะภาษาของพนักงาน

Endpoint

POST /api/v1/open-apis/employee/add-employee-profile?path_action=language-skill

Query Parameters

ParameterTypeRequiredDescription
path_actionstringYesต้องเป็น language-skill

Request Body

ParameterTypeRequiredDescription
employee_codestringYesรหัสพนักงาน
language_namestringYesชื่อภาษา
language_levelstringNoระดับความสามารถ (01, 02, 03)

Option Values

language_level

ValueDescription (TH)Description (EN)
01ดีมากExcellent
02ดีGood
03พอใช้Satisfactory

ค่า language_level ใช้สำหรับระดับความสามารถโดยรวม หากต้องการระบุแยกตามทักษะ (พูด/อ่าน/เขียน) ให้ใช้ API update แทน


Response Format

Success Response

{ "code": 200, "message": "Add Language Skill Success", "payload": { "language_skill_id": "20260213ABC1234567890", "employee_id": "20260121FC89F3BB9120", "language_name": "English", "language_level": "Advanced" } }

Response Fields

FieldTypeDescription
language_skill_idstringID ของทักษะภาษาที่สร้าง
employee_idstringID ของพนักงาน
language_namestringชื่อภาษาที่สร้าง
language_levelstringระดับความสามารถ

Error Response

{ "code": 400, "message": "Validation failed", "errors": ["Missing required parameter: 'employee_code'"] }

Validation Rules

FieldRule
employee_codeต้องระบุและต้องมีพนักงานในระบบ
language_nameต้องระบุและต้องไม่เป็นค่าว่าง
language_levelไม่บังคับ ถ้าระบุต้องเป็นค่า 01, 02, 03

Code Examples

curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/add-employee-profile?path_action=language-skill" \ -H "Content-Type: application/json" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -d '{ "employee_code": "EMP001", "language_name": "English", "language_level": "01" }'

Notes

  • สามารถเพิ่มทักษะภาษาได้หลายรายการต่อพนักงาน 1 คน
  • ระบบจะสร้าง ID และบันทึก timestamp อัตโนมัติ

Last updated on