Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Approve Complaint

พิจารณาหรืออนุมัติเอกสารร้องเรียนพนักงาน ใช้สำหรับผู้มีอำนาจ (เช่น หัวหน้างาน, ฝ่ายทรัพยากรบุคคล) ในการอนุมัติหรือปรับเปลี่ยนสถานะของเรื่องร้องเรียนผ่านสายอนุมัติ

Endpoint

POST /api/v1/open-apis/complaint/approve

Request Parameters

Required Parameters

ParameterTypeRequiredDescriptionExample
complaint_idstring (base64)YesID ของเอกสารร้องเรียนที่ต้องการอนุมัติ (Base64 encoded)MjAyNjAzMzBDTVAwMDAwMDAx
complaint_status_lvstringYesสถานะเป้าหมายที่ต้องการอนุมัติ02

Optional Parameters

ParameterTypeRequiredDescriptionExample
authorize_linestringNoลำดับสายอนุมัติที่ทำการอนุมัติในครั้งนี้true

Complaint Status Values (complaint_status_lv)

ValueENTH
01Waiting for considerationรอพิจารณา
02Consideredพิจารณาแล้ว
03In progressกำลังดำเนินการ

Request Body Example

{ "complaint_id": "MjAyNjAzMzBDTVAwMDAwMDAx", "complaint_status_lv": "02", "authorize_line": "true" }

Response Format

Success Response (HTTP 200)

{ "code": 200, "message": "อนุมัติสำเร็จ", "payload": { "complaint_id": "20260330CMP00000001", "complaint_dt": "2026-03-30", "complaint_desc": "พบเห็นการทุจริตการเบิกจ่ายงบประมาณ", "complaint_status_lv": "02", "authorize_line": "true", "message": "Approved successfully" } }

Response Fields

FieldTypeDescription
complaint_idstringรหัสเอกสารร้องเรียน
complaint_dtstringวันที่ร้องเรียน
complaint_descstringรายละเอียดการร้องเรียน
complaint_status_lvstringสถานะเอกสารหลังอนุมัติ
authorize_linestringลำดับสายอนุมัติ

Error Response - Validation Failed (HTTP 422)

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

Error Response - Document Not Found (HTTP 400)

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

Code Examples

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

Notes

ข้อควรทราบ:

  • complaint_id ใน Request ต้องเข้ารหัสด้วย Base64 แต่ใน Response จะอยู่ในรูปแบบที่ไม่ได้เข้ารหัส
  • เอกสารที่ส่งมาต้องมีอยู่จริงในระบบ หากไม่พบจะแจ้งข้อผิดพลาด
  • หากต้องการเปลี่ยนสถานะเอกสารโดยตรงโดยไม่ผ่านสายอนุมัติ ให้ใช้ API Update Status แทน
  • Get Detail - ดูรายละเอียดเอกสารและตรวจสอบสายอนุมัติ
  • Update Status - อัปเดตสถานะเอกสารโดยตรง
Last updated on