Get Warning Letter Detail

API สำหรับดูรายละเอียดจดหมายเตือน 1 ใบ ได้แก่ พนักงานที่ได้รับ วันที่ ระดับใบเตือน รายละเอียด สถานะการรับทราบ รวมถึงรายการรูปภาพ (images) และเอกสาร (files) ที่แนบไว้ พร้อม URL สำหรับเปิดไฟล์

Endpoint


POST /api/v1/open-apis/warning-letter/get-detail

สิทธิ์ที่ต้องการ: API Key ต้องมีสิทธิ์ ข้อมูลการยื่นเอกสาร (document:manage)

Request Body

ส่งแบบ application/json

Parameter	Type	Required	Description	Example
`warning_letter_id`	string	Yes	ID ของจดหมายเตือน (Base64) — ได้จาก Get List	`"MjAyNTExMjdENDU3M0M0MjE2Mzk="`
`lang`	string	No	ภาษาของ `message`: `TH` (ค่าเริ่มต้น) หรือ `EN`	`"EN"`

Request Body Example


{
  "warning_letter_id": "MjAyNTExMjdENDU3M0M0MjE2Mzk="
}

Response Format

Success Response


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": {
    "warning_letter_id": "20251127D4573C421639",
    "employee_code": "EMP001",
    "employee_name": "สมชาย ใจดี",
    "employee_name_en": "Somchai Jaidee",
    "warning_letter_dt": "2026-10-15",
    "warning_letter_flag_lv": "04",
    "warning_letter_flag_name": "หนังสือตักเตือนด้วยวาจา",
    "warning_letter_flag_name_en": "Letter of Verbal Reprimand",
    "warning_letter_desc": "มาสายเกิน 3 ครั้งในเดือน",
    "approve_flag": "01",
    "approve_flag_name": "แจ้งพนักงานแล้ว",
    "approve_flag_name_en": "Informed",
    "created": "2026-10-15 09:12:44",
    "last_upd": "2026-10-15 09:12:44",
    "images": [
      {
        "warning_letter_file_id": "20251127A1B2C3D4E5F6",
        "file_name": "evidence.jpg",
        "mime_type": "image/jpeg",
        "file_size": 183402,
        "url": "https://cdn.humansoft.co.th/.../file/3fa1c2d4e5b6a7f8.jpg"
      }
    ],
    "files": [
      {
        "warning_letter_file_id": "20251127F6E5D4C3B2A1",
        "file_name": "หนังสือเตือน.pdf",
        "mime_type": "application/pdf",
        "file_size": 92311,
        "url": "https://cdn.humansoft.co.th/.../file/9b8c7d6e5f4a3b2c.pdf"
      }
    ]
  }
}

Response Fields

Field	Type	Description
`warning_letter_id`	string	ID ของจดหมายเตือน (raw)
`employee_code`	string	รหัสพนักงานที่ได้รับจดหมายเตือน
`employee_name`	string	ชื่อ-นามสกุลพนักงาน (ภาษาไทย)
`employee_name_en`	string	ชื่อ-นามสกุลพนักงาน (ภาษาอังกฤษ)
`warning_letter_dt`	string	วันที่ของจดหมายเตือน รูปแบบ `YYYY-MM-DD`
`warning_letter_flag_lv`	string	ระดับใบเตือน (ดู Warning Letter Levels)
`warning_letter_flag_name`	string	ชื่อระดับใบเตือน (ภาษาไทย)
`warning_letter_flag_name_en`	string	ชื่อระดับใบเตือน (ภาษาอังกฤษ)
`warning_letter_desc`	string	รายละเอียด / หมายเหตุ (`""` ถ้าไม่ได้ระบุ)
`approve_flag`	string	สถานะการรับทราบ: `01` = แจ้งพนักงานแล้ว, `02` = พนักงานรับทราบแล้ว
`approve_flag_name`	string	ชื่อสถานะการรับทราบ (ภาษาไทย)
`approve_flag_name_en`	string	ชื่อสถานะการรับทราบ (ภาษาอังกฤษ)
`created`	string	วันเวลาที่สร้าง รูปแบบ `YYYY-MM-DD HH:mm:ss`
`last_upd`	string	วันเวลาที่แก้ไขล่าสุด รูปแบบ `YYYY-MM-DD HH:mm:ss`
`images`	array	รายการรูปภาพที่แนบ (`[]` ถ้าไม่มี)
`files`	array	รายการเอกสารที่แนบ (`[]` ถ้าไม่มี)

Attachment Fields (`images[]` / `files[]`)

Field	Type	Description
`warning_letter_file_id`	string	ID ของไฟล์แนบ (raw) — ใช้กับ Delete File โดย encode เป็น Base64 ก่อน
`file_name`	string	ชื่อไฟล์ต้นฉบับที่อัปโหลด
`mime_type`	string	ชนิดไฟล์ เช่น `image/jpeg`, `image/png`, `application/pdf`
`file_size`	integer	ขนาดไฟล์ (bytes)
`url`	string	URL สำหรับเปิดหรือดาวน์โหลดไฟล์

Error Response

ข้อมูลไม่ผ่านการตรวจสอบ (422)


{
  "code": 422,
  "message": "การตรวจสอบข้อมูลล้มเหลว",
  "errors": ["'warning_letter_id' is required"]
}

ข้อความใน `errors`	สาเหตุ
`'warning_letter_id' is required`	ไม่ได้ส่ง `warning_letter_id`
`'warning_letter_id' is invalid (expected the base64 of an alphanumeric id)`	`warning_letter_id` ไม่ใช่ Base64 ของ ID ที่ถูกต้อง

ไม่พบจดหมายเตือน (404)


{
  "code": 404,
  "message": "ไม่พบจดหมายเตือน"
}

HTTP Status	Description
`400`	เกิดข้อผิดพลาดระหว่างประมวลผล (`message`: `กระบวนการล้มเหลว`)
`403`	API Key ไม่มีสิทธิ์ `document:manage`
`404`	ไม่พบจดหมายเตือน — ID ไม่มีอยู่ ถูกลบไปแล้ว หรือเป็นของบริษัทอื่น
`422`	Parameter ไม่ผ่านการตรวจสอบ
`500`	เกิดข้อผิดพลาดที่เซิร์ฟเวอร์ (`message`: `เกิดข้อผิดพลาดที่เซิร์ฟเวอร์`)

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/warning-letter/get-detail" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "warning_letter_id": "MjAyNTExMjdENDU3M0M0MjE2Mzk="
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/warning-letter/get-detail',
  {
    method: 'POST',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      warning_letter_id: 'MjAyNTExMjdENDU3M0M0MjE2Mzk='
    })
  }
)
const data = await response.json()

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/warning-letter/get-detail"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "warning_letter_id": "MjAyNTExMjdENDU3M0M0MjE2Mzk="
}
 
response = requests.post(url, headers=headers, json=payload)
result = response.json()

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/warning-letter/get-detail";
$headers = [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY",
    "Content-Type: application/json"
];
$payload = [
    "warning_letter_id" => "MjAyNTExMjdENDU3M0M0MjE2Mzk="
];
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
curl_close($ch);
 
$result = json_decode($response, true);
?>

Notes

ไฟล์ที่ mime_type เป็นรูปภาพจะอยู่ใน images ไฟล์ชนิดอื่นทั้งหมดอยู่ใน files
ไฟล์ที่แนบผ่านหน้าเว็บอาจเป็นชนิดอื่นนอกจาก JPG/PNG/PDF ได้ (เช่น เอกสาร Word ใน files) แต่การอัปโหลดผ่าน API รับเฉพาะรูปภาพ JPG/PNG และ PDF
ไฟล์แนบเรียงตามลำดับที่แนบ

Get List - ค้นหาเพื่อหา warning_letter_id
Update - แก้ไขข้อมูลหรือแนบไฟล์เพิ่ม
Delete File - ลบไฟล์แนบด้วย warning_letter_file_id
Delete - ลบจดหมายเตือนทั้งใบ