Get List Complaint
ดึงรายการเอกสารร้องเรียนพนักงานทั้งหมดภายในระบบ ซึ่งข้อมูลจะครอบคลุมถึงเลขเอกสาร วันที่ร้องเรียน ประเภทของการร้องเรียน และสถานะปัจจุบันของเอกสาร
Endpoint
POST /api/v1/open-apis/complaint/get-listRequest Parameters
Required Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
req_year | string | Yes | ค้นหาตามปี (YYYY) | 2026 |
Optional Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
search | string | No | คำค้นหาจากหัวข้อร้องเรียน | ทุจริต |
from_dt | string | No | วันที่เริ่มต้น (YYYY-MM-DD) | 2026-03-01 |
to_dt | string | No | วันที่สิ้นสุด (YYYY-MM-DD) | 2026-03-31 |
req_month | string | No | ค้นหาตามเดือน (MM) หรือปล่อยว่าง | 03 |
complaint_status_lv | string | No | กรองจากสถานะการร้องเรียน | 01 |
complaint_type_lv | string | No | กรองจากประเภทประเด็นร้องเรียน | 02 |
employee_lists | array | No | ค้นหาข้อมูลรายบุคคล ([{"id":"base64"}]) | [{"id":"MjAyNTAz..."}] |
authorize_line | boolean | No | กรองเฉพาะรายการที่ตนเองมีสิทธิ์เป็นผู้อนุมัติ | true |
hashtags | array | No | คำค้นหาแบบ Array ของ String | ["ทุจริต"] |
Complaint Type Values (complaint_type_lv)
| Value | EN | TH |
|---|---|---|
01 | Corruption | ทุจริต |
02 | Breaking the rules | ไม่ปฏิบัติตามกฎระเบียบ |
03 | Bullied, Intimidated | ถูกกลั่นแกล้ง ข่มขู่ |
04 | Work failed | ปฏิบัติงานผิดพลาด |
05 | Working behavior | พฤติกรรมการทำงาน |
06 | Others | อื่นๆ |
Complaint Status Values (complaint_status_lv)
| Value | EN | TH |
|---|---|---|
01 | Waiting for consideration | รอพิจารณา |
02 | Considered | พิจารณาแล้ว |
03 | In progress | กำลังดำเนินการ |
Request Body Example
{
"req_year": "2026",
"from_dt": "2026-03-01",
"to_dt": "2026-03-31",
"complaint_status_lv": "01"
}Response Format
Success Response (HTTP 200)
{
"code": 200,
"message": "สำเร็จ",
"payload": [
{
"complaint_id": "20260330CMP00000001",
"complaint_dt": "2026-03-30",
"complaint_type_lv": "01",
"complaint_desc": "พบเห็นการทุจริตการเบิกจ่ายงบประมาณ",
"complaint_status_lv": "01",
"informer_employee_name": "สมชาย ใจดี"
},
{
"complaint_id": "20260329CMP00000002",
"complaint_dt": "2026-03-29",
"complaint_type_lv": "02",
"complaint_desc": "พนักงานปฏิบัติงานก่อให้เกิดอันตราย",
"complaint_status_lv": "02",
"informer_employee_name": "ไม่เปิดเผยข้อมูล"
}
]
}Response Fields
| Field | Type | Description |
|---|---|---|
complaint_id | string | รหัสเอกสารร้องเรียน |
complaint_dt | string | วันที่ร้องเรียน |
complaint_type_lv | string | รหัสประเภทการร้องเรียน |
complaint_desc | string | รายละเอียดการร้องเรียน |
complaint_status_lv | string | สถานะเอกสาร |
informer_employee_name | string | ชื่อผู้ร้องเรียน (แสดง “ไม่เปิดเผยข้อมูล” หากเป็น Anonymous) |
Error Response - Bad Request (HTTP 400)
{
"code": 400,
"message": "Failed",
"error": "เกิดข้อผิดพลาดในการดึงข้อมูล"
}Code Examples
cURL
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/complaint/get-list" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"req_year": "2026",
"from_dt": "2026-03-01",
"to_dt": "2026-03-31"
}'Notes
ข้อควรทราบ:
- ยิ่งมีรายการมาก ขนาด Payload จะยิ่งใหญ่ขึ้น ควรกรองการค้นหาด้วยวันที่ (
from_dt,to_dt) ทุกครั้ง - ถ้าระบุ
from_dtและto_dtต้องใช้รูปแบบYYYY-MM-DDเท่านั้น - ภายใน
employee_listsค่าของidต้องเป็น Base64 encoded
Related APIs
- Get Detail - ใช้
complaint_idที่ได้จากรายการเพื่อดูรายละเอียดเจาะลึก - Submit Complaint - สร้างเอกสารร้องเรียนใหม่
Last updated on