HTTP Attendance API

ภาพรวม

ประตูหน้า HTTPS ที่ไม่ขึ้นกับอุปกรณ์ สำหรับรับข้อมูลการลงเวลา heartbeat และการตรวจสอบการสมัครใช้งานจากไคลเอนต์ใดก็ได้

HTTP Attendance API คือประตูหน้าที่ไม่ขึ้นกับอุปกรณ์ที่พาธ /api/attendance/v1/{op} ยืนยันตัวตนแต่ละคำขอด้วยเฮดเดอร์หมายเลขซีเรียลอุปกรณ์ (sn) และ auth-token แล้วรับข้อมูล เปิดให้ใช้ punch (อีเวนต์การลงเวลาที่จดจำได้หนึ่งรายการ), heartbeat (สถานะการออนไลน์ของอุปกรณ์), validity (การตรวจสอบการสมัครใช้งาน) และ config การลงเวลาไหลเข้าไปป์ไลน์ร่วม ให้การจัดเก็บและการพุชไปยังเซิร์ฟเวอร์ลูกค้าปลายทางเหมือนกันกับทรานสปอร์ต HTTP, TCP และ MQTT แท้ — การผสานรวมจึงสอดคล้องกันไม่ว่าข้อมูลการลงเวลาจะมาทางใด

APIRESTHTTPSJSONC++

ใช้ใน:โรงเรียน วิทยาลัย และสถานศึกษา

POST /api/attendance/v1/punch

curl https://api.camsbiometrics.com/api/attendance/v1/punch \
  -H "sn: SN7A2300583" -H "auth-token: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "user_id":"1001", "att_time":"2026-06-21 09:30:00",
        "att_state":1, "input_type":50 }'
# -> 200 {"ok":true}

ความสามารถ

ทำอะไรได้บ้าง

รับข้อมูลการลงเวลา

POST อีเวนต์การลงเวลาที่จดจำได้หนึ่งรายการ พร้อมผู้ใช้ เวลา สถานะ IN/OUT ประเภทอินพุต และตำแหน่งที่เลือกได้

รายงานสถานะการออนไลน์

ส่ง heartbeat เพื่อทำเครื่องหมายอุปกรณ์ว่าออนไลน์โดยไม่ต้องมี body

ตรวจสอบความถูกต้อง

สอบถามว่าการสมัครใช้งานการลงเวลาของอุปกรณ์ยังใช้งานอยู่หรือไม่ก่อนส่งข้อมูล

ไปป์ไลน์แบบรวม

ทุกการลงเวลาเข้าสู่เส้นทางจัดเก็บและพุชเดียวกับการรับข้อมูล TCP และ MQTT แท้

คุณสมบัติ

รวมทุกอย่างไว้ให้

HTTPS ingress เดียวสำหรับไคลเอนต์แบบ edge แอป เว็บ และไฮบริดที่ /api/attendance/v1/{op}
การยืนยันตัวตนผ่านเฮดเดอร์: หมายเลขซีเรียลอุปกรณ์ (sn) พร้อม auth-token และการควบคุมตามการสมัครใช้งาน
endpoint punch รับอีเวนต์การลงเวลาที่จดจำได้ (ผู้ใช้ เวลา IN/OUT ประเภทอินพุต พิกัดตำแหน่งที่เลือกได้)
endpoint heartbeat ทำเครื่องหมายอุปกรณ์ว่าออนไลน์เพื่อติดตามสถานะ
endpoint validity ส่งคืนสถานะการสมัครใช้งานล่าสุดก่อนที่ไคลเอนต์จะส่งข้อมูล
ไปป์ไลน์ร่วม: การจัดเก็บและการพุชไปยังเซิร์ฟเวอร์ลูกค้าเหมือนกับเอนจินแท้
สัญญาข้อผิดพลาด JSON ที่สอดคล้องกันสำหรับกรณีไม่มีหมายเลขซีเรียล อุปกรณ์ที่ไม่รู้จัก token ไม่ถูกต้อง หรือการสมัครใช้งานที่ไม่ใช้งาน
มี nginx อยู่ด้านหน้า พร้อมเพดานขนาด body และการจำกัดอัตรา

สร้างด้วย HTTP Attendance API

รับคีย์ อ่านเอกสาร แล้วส่งมอบ ทีมของเราช่วยดูแลการผสานรวมครั้งแรกของคุณ

คุยกับวิศวกร WhatsApp

คำถามที่พบบ่อย