Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Get List Complaint

ดึงรายการเอกสารร้องเรียนพนักงานทั้งหมดภายในระบบ ซึ่งข้อมูลจะครอบคลุมถึงเลขเอกสาร วันที่ร้องเรียน ประเภทของการร้องเรียน และสถานะปัจจุบันของเอกสาร

Endpoint

POST /api/v1/open-apis/complaint/get-list

Request Parameters

Required Parameters

ParameterTypeRequiredDescriptionExample
req_yearstringYesค้นหาตามปี (YYYY)2026

Optional Parameters

ParameterTypeRequiredDescriptionExample
searchstringNoคำค้นหาจากหัวข้อร้องเรียนทุจริต
from_dtstringNoวันที่เริ่มต้น (YYYY-MM-DD)2026-03-01
to_dtstringNoวันที่สิ้นสุด (YYYY-MM-DD)2026-03-31
req_monthstringNoค้นหาตามเดือน (MM) หรือปล่อยว่าง03
complaint_status_lvstringNoกรองจากสถานะการร้องเรียน01
complaint_type_lvstringNoกรองจากประเภทประเด็นร้องเรียน02
employee_listsarrayNoค้นหาข้อมูลรายบุคคล ([{"id":"base64"}])[{"id":"MjAyNTAz..."}]
authorize_linebooleanNoกรองเฉพาะรายการที่ตนเองมีสิทธิ์เป็นผู้อนุมัติtrue
hashtagsarrayNoคำค้นหาแบบ Array ของ String["ทุจริต"]

Complaint Type Values (complaint_type_lv)

ValueENTH
01Corruptionทุจริต
02Breaking the rulesไม่ปฏิบัติตามกฎระเบียบ
03Bullied, Intimidatedถูกกลั่นแกล้ง ข่มขู่
04Work failedปฏิบัติงานผิดพลาด
05Working behaviorพฤติกรรมการทำงาน
06Othersอื่นๆ

Complaint Status Values (complaint_status_lv)

ValueENTH
01Waiting for considerationรอพิจารณา
02Consideredพิจารณาแล้ว
03In 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

FieldTypeDescription
complaint_idstringรหัสเอกสารร้องเรียน
complaint_dtstringวันที่ร้องเรียน
complaint_type_lvstringรหัสประเภทการร้องเรียน
complaint_descstringรายละเอียดการร้องเรียน
complaint_status_lvstringสถานะเอกสาร
informer_employee_namestringชื่อผู้ร้องเรียน (แสดง “ไม่เปิดเผยข้อมูล” หากเป็น Anonymous)

Error Response - Bad Request (HTTP 400)

{ "code": 400, "message": "Failed", "error": "เกิดข้อผิดพลาดในการดึงข้อมูล" }

Code Examples

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
  • Get Detail - ใช้ complaint_id ที่ได้จากรายการเพื่อดูรายละเอียดเจาะลึก
  • Submit Complaint - สร้างเอกสารร้องเรียนใหม่
Last updated on