Delete Warning Letter

API สำหรับลบจดหมายเตือน 1 ใบ พร้อมไฟล์แนบทั้งหมด และนำการ์ดจดหมายเตือนออกจาก News Feed ของพนักงาน ลบได้เฉพาะจดหมายเตือนที่พนักงานยังไม่รับทราบ (approve_flag = 01)

การลบไม่สามารถกู้คืนได้

Endpoint


POST /api/v1/open-apis/warning-letter/delete

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

Request Body

ส่งแบบ application/json

Parameter	Type	Required	Description	Example
`warning_letter_id`	string	Yes	ID ของจดหมายเตือนที่ต้องการลบ (Base64)	`"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"
  }
}

Field	Type	Description
`warning_letter_id`	string	ID ของจดหมายเตือนที่ถูกลบ (raw)

Success Response with Warnings

จดหมายเตือนถูกลบแล้ว แต่งานต่อเนื่องบางส่วนไม่สำเร็จ — ระบบคืน HTTP 200 พร้อม warnings (ไม่ต้องส่งคำขอซ้ำ)


{
  "code": 200,
  "message": "ลบจดหมายเตือนสำเร็จ",
  "payload": {
    "warning_letter_id": "20251127D4573C421639"
  },
  "warnings": [
    "an attachment could not be removed from storage"
  ]
}

ข้อความใน `warnings`	ความหมาย
`news feed could not be removed`	นำการ์ดจดหมายเตือนออกจาก News Feed ไม่สำเร็จ
`an attachment could not be removed from storage` / `attachment storage cleanup failed`	ลบไฟล์แนบออกจากที่จัดเก็บไฟล์ไม่สำเร็จ

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": "ไม่พบจดหมายเตือน"
}

พนักงานรับทราบแล้ว (409)


{
  "code": 409,
  "message": "พนักงานรับทราบจดหมายเตือนนี้แล้ว ไม่สามารถแก้ไขหรือลบได้"
}

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

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/warning-letter/delete" \
  -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/delete',
  {
    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/delete"
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/delete";
$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

API นี้ไม่อนุญาตให้ลบจดหมายเตือนที่พนักงานรับทราบแล้ว
การลบไม่ส่งแจ้งเตือนถึงพนักงาน และแจ้งเตือนเรื่องจดหมายเตือนนี้ที่พนักงานได้รับไปก่อนหน้ายังคงอยู่ในรายการแจ้งเตือนของพนักงาน
หลังลบ จดหมายเตือนจะไม่แสดงใน Get List และ Get Detail จะคืน HTTP 404

Get Detail - ตรวจสถานะ approve_flag ก่อนลบ
Delete File - ลบเฉพาะไฟล์แนบบางไฟล์
Get List - ค้นหารายการจดหมายเตือน