Add Employee Language Skill
เพิ่มทักษะภาษาของพนักงาน
Endpoint
POST /api/v1/open-apis/employee/add-employee-profile?path_action=language-skillQuery Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
path_action | string | Yes | ต้องเป็น language-skill |
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
employee_code | string | Yes | รหัสพนักงาน |
language_name | string | Yes | ชื่อภาษา |
language_level | string | No | ระดับความสามารถ (01, 02, 03) |
Option Values
language_level
| Value | Description (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
| Field | Type | Description |
|---|---|---|
language_skill_id | string | ID ของทักษะภาษาที่สร้าง |
employee_id | string | ID ของพนักงาน |
language_name | string | ชื่อภาษาที่สร้าง |
language_level | string | ระดับความสามารถ |
Error Response
{
"code": 400,
"message": "Validation failed",
"errors": ["Missing required parameter: 'employee_code'"]
}Validation Rules
| Field | Rule |
|---|---|
employee_code | ต้องระบุและต้องมีพนักงานในระบบ |
language_name | ต้องระบุและต้องไม่เป็นค่าว่าง |
language_level | ไม่บังคับ ถ้าระบุต้องเป็นค่า 01, 02, 03 |
Code Examples
cURL
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 อัตโนมัติ
Related APIs
- List Language Skills - ดึงรายการทักษะภาษาทั้งหมด
- Get Language Skill - ดึงข้อมูลทักษะภาษาตาม ID
- Update Language Skill - แก้ไขทักษะภาษา
- Delete Language Skill - ลบทักษะภาษา
Last updated on