HTTP Attendance API

Tổng quan

Một cửa HTTPS không phụ thuộc thiết bị để tiếp nhận các lượt chấm công, heartbeat và kiểm tra đăng ký từ bất kỳ client nào.

HTTP Attendance API là cửa trước không phụ thuộc thiết bị tại đường dẫn /api/attendance/v1/{op}. Nó xác thực mỗi yêu cầu bằng header số sê-ri thiết bị (sn) và auth-token, rồi tiếp nhận. Nó cung cấp punch (một sự kiện chấm công đã nhận dạng), heartbeat (trạng thái hiện diện của thiết bị), validity (kiểm tra đăng ký) và config. Các lượt chấm công được đưa vào pipeline dùng chung, cho cùng cách lưu trữ và đẩy đến máy chủ khách hàng như các phương thức truyền tải HTTP, TCP và MQTT gốc — nhờ đó tích hợp luôn nhất quán bất kể dữ liệu chấm công đến bằng cách nào.

APIRESTHTTPSJSONC++

Được dùng trong:Trường học, đại học & khuôn viên

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}

Khả năng

Nó làm được gì

Tiếp nhận lượt chấm công

POST một sự kiện chấm công đã nhận dạng kèm người dùng, dấu thời gian, trạng thái VÀO/RA, loại đầu vào và vị trí tùy chọn.

Báo cáo hiện diện

Gửi heartbeat để đánh dấu thiết bị trực tuyến mà không cần body.

Kiểm tra hiệu lực

Truy vấn xem đăng ký chấm công của thiết bị còn hiệu lực hay không trước khi gửi dữ liệu.

Pipeline thống nhất

Mỗi lượt chấm công đi vào cùng đường dẫn lưu trữ và đẩy như tiếp nhận TCP và MQTT gốc.

Tính năng

Tất cả đều có sẵn

Một điểm tiếp nhận HTTPS duy nhất cho client edge, ứng dụng, web và lai tại /api/attendance/v1/{op}
Xác thực qua header: số sê-ri thiết bị (sn) cộng auth-token, kèm kiểm soát đăng ký
Endpoint punch tiếp nhận một sự kiện chấm công đã nhận dạng (người dùng, thời gian, VÀO/RA, loại đầu vào, định vị tùy chọn)
Endpoint heartbeat đánh dấu thiết bị trực tuyến để theo dõi hiện diện
Endpoint validity trả về trạng thái đăng ký trực tiếp trước khi client gửi dữ liệu
Pipeline dùng chung: cùng cách lưu trữ và đẩy đến máy chủ khách hàng như các engine gốc
Hợp đồng lỗi JSON nhất quán cho trường hợp thiếu số sê-ri, thiết bị không xác định, token không hợp lệ hoặc đăng ký không hoạt động
Đặt sau nginx với giới hạn kích thước body và giới hạn tốc độ

Xây dựng với HTTP Attendance API

Lấy khóa, đọc tài liệu và triển khai. Đội ngũ của chúng tôi hỗ trợ bạn trong lần tích hợp đầu tiên.

Trao đổi với kỹ sư WhatsApp

Câu hỏi thường gặp