Get IOMO Logs - Gofive OpenAPI

ดึง log คำสั่งของเครื่องสแกน

ดึงรายการคำสั่งที่ระบบส่งไปยังเครื่องสแกนลงเวลา พร้อมเวลาที่สั่ง เวลาที่ส่งถึงเครื่อง เวลาที่เครื่องตอบกลับ
และค่าที่เครื่องคืนมา ทุก parameter เป็นตัวกรองและไม่บังคับ

🎛️ ค่าเริ่มต้นและการแบ่งหน้า

take = 0 หมายถึงเอาทุกรายการ (ไม่จำกัด) — เป็นค่าที่ใช้เมื่อไม่ส่งมา

skip = 0

ผลลัพธ์เรียงตาม DeviceId แล้วตาม CommitTime จากใหม่ไปเก่า

⚠️ ข้อควรรู้

ต้องส่ง dateStart และ dateEnd มาคู่กันเสมอ — ส่งมาเพียงตัวเดียวจะได้ผลลัพธ์ว่าง (204) เพราะเงื่อนไขช่วงวันที่ฝั่งฐานข้อมูลใช้ BETWEEN ที่ต้องมีทั้งสองค่า; ไม่ส่งทั้งคู่ = ไม่กรองวันที่

ช่วงวันที่ย้อนหลังถูกจำกัดตามแพ็กเกจของ tenant — ระบบจะขยับ dateStart ขึ้นมาเท่าที่อนุญาต และถ้าช่วงที่ขอทั้งช่วงเก่ากว่าที่อนุญาต จะได้ 204 (ไม่ใช่ error)

dateEnd ที่เป็นอนาคตจะถูกลดลงมาเป็นวันปัจจุบัน

employeeRefId ไม่มีผลกับ endpoint นี้ — log เป็นระดับเครื่อง ไม่ได้ผูกกับพนักงาน

🔐 ต้องมีสิทธิ์ใช้ Open API หมวดเวลาทำงาน (Time)

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

สำเร็จ — Data คือรายการ log คำสั่งที่ตรงตัวกรอง

Bodyapplication/json

Example

{
    "Status": {
        "Code": "1000",
        "Description": "Success!"
    },
    "Data": [
        {
            "Content": "SyncUser",
            "CommitTime": "2026-06-30T07:40:00",
            "TransTime": "2026-06-30T07:40:05",
            "ResponseTime": "2026-06-30T07:40:07",
            "ReturnValue": "OK",
            "DeviceId": 88,
            "DeviceName": "เครื่องสแกนตัวอย่าง ประตูหน้า",
            "DeviceName_EN": "Sample Scanner Front Gate",
            "SerialNo": "SN-EXAMPLE-0001",
            "IPAddress": "203.0.113.10",
            "Port": 4370
        },
        {
            "Content": "SyncUser",
            "CommitTime": "2026-06-30T07:45:00",
            "TransTime": "2026-06-30T07:45:04",
            "ResponseTime": "0001-01-01T00:00:00",
            "ReturnValue": null,
            "DeviceId": 88,
            "DeviceName": "เครื่องสแกนตัวอย่าง ประตูหน้า",
            "DeviceName_EN": "Sample Scanner Front Gate",
            "SerialNo": "SN-EXAMPLE-0001",
            "IPAddress": "203.0.113.10",
            "Port": 4370
        }
    ]
}

🟢204No Content

🟠401Unauthorized

🟠403Forbidden

🟠429Too Many Requests

🔴500Server Error