ดึงคิวงานรอตรวจ

ดึงรายการงานที่รอผู้ใช้ของ token ตรวจ พร้อมข้อมูลแบ่งหน้า
คิวนี้คิดสิทธิ์รายงานให้แล้ว — เห็นเฉพาะงานที่ผู้ใช้คนนั้นตรวจได้จริง

⚠️ ข้อควรรู้

companyName บังคับส่ง — ไม่ส่งจะได้ 400 (INVALID_REQUEST) เพราะ employeeRefId ไม่ซ้ำกันเฉพาะภายในบริษัทเดียว

ตอนนี้รองรับเฉพาะ status=WaitingForApproval ส่งสถานะอื่นจะได้ 400 (INVALID_REQUEST) ไม่ใช่รายการว่าง — เพราะยังไม่มีวิธีอ่านสถานะอื่นที่คิดสิทธิ์ผู้ตรวจได้ถูกต้อง

includeAttachments ทำให้ผลลัพธ์ช้าลงและตอนนี้ไม่ได้เพิ่มฟิลด์ในรายการคิว (จำนวนไฟล์ดูได้จาก AttachmentCount อยู่แล้ว) — เปิดเฉพาะเมื่อจำเป็นจริง ๆ

🎛️ การแบ่งหน้า — ค่าที่หลุดกรอบถูกปรับให้อยู่ในช่วงเงียบ ๆ ไม่ใช่ 400

page น้อยกว่า 1 → ปรับเป็น 1

pageSize น้อยกว่า 1 หรือมากกว่า 100 → ปรับเป็น 20

ขอหน้าที่เลยจำนวนข้อมูลจะได้ 200 พร้อม Items ว่างและ Pagination ที่บอกจำนวนจริง — ไม่มี 204

🔐 ต้องมีสิทธิ์ Open API โมดูล Mission ระดับ Read

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

สำเร็จ — Data.Items คือคิวงาน และ Data.Pagination บอกจำนวนทั้งหมด (Totals = TotalItems)

Bodyapplication/json

Example

{
    "StatusCode": 200,
    "Message": "OK",
    "Totals": 2,
    "Data": {
        "Items": [
            {
                "EmployeeMissionTaskId": 90101,
                "MissionName": "ภารกิจตัวอย่าง ประจำเดือน",
                "TaskName": "ส่งรายงานประจำเดือน",
                "Employee": {
                    "EmployeeRefId": "EMP001",
                    "CompanyName": "Acme",
                    "FullName": "พนักงานตัวอย่าง หนึ่ง",
                    "AvatarURL": "https://cdn.example.com/avatar-emp001.png"
                },
                "DateDue": "2026-07-05T00:00:00",
                "DateLastSubmitted": "2026-07-04T16:20:00",
                "TaskStatus": "WaitingForApproval",
                "IsOverdue": false,
                "Remark": "ส่งรายงานฉบับแก้ไขแล้ว",
                "AttachmentCount": 2
            },
            {
                "EmployeeMissionTaskId": 90102,
                "MissionName": "ภารกิจตัวอย่าง ประจำเดือน",
                "TaskName": "ส่งรายงานประจำเดือน",
                "Employee": {
                    "EmployeeRefId": "EMP002",
                    "CompanyName": "Acme",
                    "FullName": "พนักงานตัวอย่าง สอง",
                    "AvatarURL": null
                },
                "DateDue": "2026-07-05T00:00:00",
                "DateLastSubmitted": "2026-07-08T09:10:00",
                "TaskStatus": "WaitingForApproval",
                "IsOverdue": true,
                "Remark": null,
                "AttachmentCount": 0
            }
        ],
        "Pagination": {
            "Page": 1,
            "PageSize": 20,
            "TotalItems": 2,
            "TotalPages": 1
        }
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠429

🔴500Server Error