Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Get Detail Complaint

ดึงข้อมูลรายละเอียดเจาะลึกของเอกสารร้องเรียนพนักงาน 1 รายการ ซึ่งรวมถึงข้อมูลของผู้ร้องเรียน ผู้ถูกร้องเรียน โครงสร้างองค์กร และข้อมูลสายการอนุมัติ

Endpoint

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

Request Parameters

Required Parameters

ParameterTypeRequiredDescriptionExample
complaint_idstring (base64)YesID ของเอกสารที่ต้องการดูรายละเอียด (Base64 encoded)MjAyNjAzMzBDTVAwMDAwMDAx

Optional Parameters

ParameterTypeRequiredDescriptionExample
language_codestringNoภาษาการส่งคืนข้อมูล (TH หรือ EN ค่าเริ่มต้นคือ TH)TH

Request Body Example

{ "complaint_id": "MjAyNjAzMzBDTVAwMDAwMDAx", "language_code": "TH" }

Response Format

Success Response (HTTP 200)

{ "code": 200, "message": "สำเร็จ", "payload": { "complaint_id": "20260330CMP00000001", "complaint_dt": "2026-03-30", "complaint_employee_id": "20260309462FEF65EFCA", "informer_employee_id": "2025030351B0A2CCBD9C", "complaint_type_lv": "01", "complaint_desc": "พบเห็นการทุจริตการเบิกจ่ายงบประมาณ", "complaint_attachment": "https://example.com/complaint/image/1234567890.png", "complaint_status_lv": "01", "complaint_status_name": "รอพิจารณา", "complaint_status_name_en": "Waiting for consideration", "complaint_type_name": "ทุจริต", "complaint_type_name_en": "Corruption", "complaint_visible_lv": "N", "informer_employee_name": "สมชาย", "informer_employee_last_name": "ใจดี", "informer_employee_photograph": "images/userPlaceHolder.png", "complaint_employee_name": "สมเกียรติ", "complaint_employee_last_name": "ทำงานไว", "complaint_employee_photograph": "images/userPlaceHolder.png", "auth_first": "20230101ABCD1234EFGH", "auth_first_name": "สมหญิง", "auth_first_last_name": "บริหารยอด", "edit_approve": true, "organization": { "department": { "label": "แผนก", "value": "ไอที" }, "position": { "label": "ตำแหน่ง", "value": "Programmer" } } } }

Response Fields

FieldTypeDescription
complaint_idstringรหัสเอกสารร้องเรียน
complaint_dtstringวันที่ร้องเรียน
complaint_employee_idstringID ของพนักงานที่ถูกร้องเรียน
informer_employee_idstringID ของผู้ร้องเรียน
complaint_type_lvstringรหัสประเภทการร้องเรียน
complaint_descstringรายละเอียดการร้องเรียน
complaint_attachmentstringURL รูปภาพหลักฐานแนบ
complaint_status_lvstringรหัสสถานะเอกสาร
complaint_status_namestringชื่อสถานะ (ภาษาไทย)
complaint_status_name_enstringชื่อสถานะ (ภาษาอังกฤษ)
complaint_type_namestringชื่อประเภทร้องเรียน (ภาษาไทย)
complaint_type_name_enstringชื่อประเภทร้องเรียน (ภาษาอังกฤษ)
complaint_visible_lvstringระดับการแสดงตัวตน
informer_employee_namestringชื่อผู้ร้องเรียน
informer_employee_last_namestringนามสกุลผู้ร้องเรียน
informer_employee_photographstringรูปภาพผู้ร้องเรียน
complaint_employee_namestringชื่อพนักงานที่ถูกร้องเรียน
complaint_employee_last_namestringนามสกุลพนักงานที่ถูกร้องเรียน
complaint_employee_photographstringรูปภาพพนักงานที่ถูกร้องเรียน
auth_firststringID ผู้อนุมัติลำดับแรก
auth_first_namestringชื่อผู้อนุมัติลำดับแรก
auth_first_last_namestringนามสกุลผู้อนุมัติลำดับแรก
edit_approvebooleanสามารถทำการอนุมัติได้หรือไม่
organizationobjectข้อมูลโครงสร้างองค์กร (แผนก, ตำแหน่ง)

Error Response - Validation Failed (HTTP 422)

{ "code": 422, "message": "Validation failed", "errors": [ "'complaint_id' is required" ] }

Error Response - Not Found (HTTP 400)

{ "code": 400, "message": "Failed", "error": "ไม่พบข้อมูลเอกสารในระบบ" }

Code Examples

curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/complaint/get-detail" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "complaint_id": "MjAyNjAzMzBDTVAwMDAwMDAx", "language_code": "TH" }'

Notes

ข้อควรทราบ:

  • complaint_id ใน Request ต้องเข้ารหัสด้วย Base64 แต่ใน Response จะอยู่ในรูปแบบที่ไม่ได้เข้ารหัส
  • บางฟิลด์จะไม่แสดงถ้าไม่มีข้อมูล
  • หากตั้ง complaint_visible_lv เป็น N ข้อมูลผู้ร้องเรียนจะยังส่งกลับมาใน Response แต่ฝั่ง Frontend ควรซ่อนข้อมูลและแสดงเป็น “ไม่เปิดเผยข้อมูล” แทน
  • หาก edit_approve เป็น true แสดงว่าผู้ใช้งานสามารถทำการอนุมัติเอกสารนี้ได้
  • Approve - อนุมัติเอกสารเมื่อ edit_approve เป็น true
  • Get List - ดูรายการเอกสารร้องเรียนทั้งหมด
Last updated on