Support Hub/API & Integrations/Webhook so với Polling: Dữ liệu sinh trắc học thời gian…
Translated from the English article and reviewed by a person. Read the English original
Developer

Webhook so với Polling: Dữ liệu sinh trắc học thời gian thực nên đến máy chủ của bạn như thế nào

Webhook so với Polling: Dữ liệu sinh trắc học thời gian thực nên đến máy chủ của bạn như thế nào

Mọi tích hợp sinh trắc học đều phải trả lời một câu hỏi cơ bản: làm thế nào để một lần quét tại cửa trở thành một bản ghi trong hệ thống của bạn? Có hai cách. Máy chủ của bạn có thể liên tục hỏi thiết bị xem có điều gì mới xảy ra hay không, đó là polling. Hoặc hệ thống có thể báo cho máy chủ của bạn ngay khi có sự kiện, đó là webhook. Với dữ liệu chấm công và kiểm soát ra vào bằng sinh trắc học, việc chọn webhook hay polling ảnh hưởng đến độ mới của dữ liệu, mức tải bạn đặt lên thiết bị và mạng, cũng như độ tin cậy của các bản ghi. Hướng dẫn này giải thích cả hai cách bằng ngôn ngữ đơn giản, chỉ ra vì sao webhook là lựa chọn mặc định tốt hơn cho dữ liệu sinh trắc học, trình bày cách xây dựng bộ tiếp nhận webhook đáng tin cậy, và giải thích polling vẫn có vị trí ở đâu.

01 · Pull so với Push

Hai cách dữ liệu có thể truyền đi

Hãy tưởng tượng bạn đang chờ một kiện hàng quan trọng. Bạn có thể cứ năm phút lại đi ra cửa trước để xem hàng đã đến chưa. Hoặc bạn có thể chờ chuông cửa reo. Cả hai cách đều giúp bạn nhận được hàng. Cách đầu tốn rất nhiều lần đi lại và vẫn có thể trễ tới năm phút. Cách sau cho bạn biết ngay khi hàng đến.

Đó là sự khác biệt giữa polling và webhook.

Polling: máy chủ của bạn liên tục hỏi

Máy chủ của bạn

Hỏi: có lần quét mới nào kể từ lần trước không?

→

Thiết bị hoặc hệ thống

Trả lời: không có gì mới

→

Chờ

Ngủ trong khoảng thời gian polling

→

Lặp lại

Hỏi lại, và cứ thế suốt cả ngày

Webhook: hệ thống tự báo cho máy chủ của bạn

Nhân viên quét

Một lần quét vân tay, khuôn mặt hoặc thẻ đã được xác minh

→

Gateway

Gửi sự kiện ngay đến URL webhook của bạn

→

Máy chủ của bạn

Nhận sự kiện và trả về done

→

Done

Không phải chờ và không có yêu cầu thừa

Polling Webhook
Ai bắt đầu cuộc trao đổi Máy chủ của bạn Hệ thống đang giữ dữ liệu
Khi dữ liệu đến Ở lần polling tiếp theo, trễ tối đa một chu kỳ đầy đủ Ngay sau khi quét
Số yêu cầu khi không có gì xảy ra Liên tục, hầu hết đều trống Không có
Tải lên thiết bị và mạng Liên tục, bất kể có hoạt động hay không Chỉ khi có gì đó cần gửi
Độ phức tạp đối với bạn Phải theo dõi những gì đã lấy về Nhận và xác nhận sự kiện

02 · Những chi phí ẩn

Vì sao polling gặp khó với dữ liệu sinh trắc học

Polling phù hợp với dữ liệu thay đổi chậm hoặc những trường hợp độ trễ không quan trọng. Dữ liệu chấm công và kiểm soát ra vào bằng sinh trắc học thì ngược lại. Dữ liệu được tạo ra thành từng đợt dồn dập vào lúc bắt đầu và kết thúc ca, phần còn lại trong ngày thì khá yên ắng, và thường cần được xử lý ngay lập tức.

Độ trễ đã được tích hợp sẵn

Với polling, độ trễ xấu nhất luôn bằng chu kỳ polling của bạn. Một lần quét xảy ra một giây sau lần polling sẽ phải chờ trọn chu kỳ thì máy chủ của bạn mới thấy được.

Chu kỳ polling Độ trễ xấu nhất trước khi hệ thống của bạn biết Phù hợp cho
Mỗi 24 giờ Tối đa một ngày đầy đủ Chỉ cho bảng lương hàng tháng
Mỗi giờ Tối đa 60 phút Báo cáo hàng ngày
Mỗi 5 phút Tối đa 5 phút Hầu hết bảng điều khiển, không dùng cho cảnh báo
Mỗi phút Tối đa 60 giây Gần thời gian thực, nhưng tốn nhiều yêu cầu
Webhook Không có độ trễ polling Bảng điều khiển trực tiếp, thông báo và tự động hóa

Phần lớn yêu cầu bị lãng phí

Để tiến gần hơn tới thời gian thực, bạn polling thường xuyên hơn. Nhưng phần lớn các yêu cầu đó không trả về gì. Polling một thiết bị mỗi phút nghĩa là 1.440 yêu cầu mỗi thiết bị mỗi ngày. Với 50 thiết bị, đó là 72.000 yêu cầu mỗi ngày, hầu hết đều đặt một câu hỏi mà câu trả lời là “không có gì mới.” Mỗi yêu cầu đó đều tiêu tốn băng thông mạng và thời gian xử lý của thiết bị.

Việc theo dõi trở nên mong manh

Một tích hợp polling phải nhớ những gì đã lấy về, thường bằng cách lưu thời điểm hoặc vị trí của bản ghi cuối cùng đã thấy. Nếu mốc đó sai, do khởi động lại, chênh lệch đồng hồ giữa máy chủ và thiết bị, hoặc các bản ghi được lưu khi thiết bị đang ngoại tuyến, thì tích hợp sẽ bỏ sót lần quét hoặc nhập trùng lặp. Những vấn đề này diễn ra âm thầm và thường chỉ lộ ra khi có tranh chấp về bảng lương.

Càng nhiều địa điểm càng khó

Với một thiết bị, polling vẫn dễ quản lý. Nhưng với hàng chục thiết bị trên nhiều địa điểm và nhiều thương hiệu, mỗi thiết bị có kết nối, chu kỳ và mốc lấy dữ liệu cuối riêng, polling trở thành một công việc lập lịch và giám sát riêng biệt.

Polling hỏi cùng một câu hỏi hàng nghìn lần mỗi ngày để bắt được vài thời điểm quan trọng. Webhook chỉ lên tiếng khi thực sự có sự kiện xảy ra.

03 · Gửi dữ liệu push với Cams

Webhook sinh trắc học hoạt động như thế nào

Với Cams Biometrics Gateway, việc gửi webhook được gọi là Callback API. Bạn cung cấp cho Gateway một URL trên máy chủ của mình, và mỗi lần quét đã xác minh sẽ được gửi đến URL đó ngay khi xảy ra. Các sự kiện callback được gửi với độ trễ bằng không đối với thiết bị dùng Native Push.

Máy chủ của bạn nhận được gì

Callback API, yêu cầu được Gateway gửi đến URL webhook của bạn

{
  "RealTime": {
    "OperationID": "9nu1wak5616p",
    "LabelName": "Burj Khalifa",
    "SerialNumber": "ZHM11xxxxxxxx",
    "PunchLog": {
      "Type": "CheckOut",
      "Temperature": "36.8",
      "FaceMask": false,
      "InputType": "Fingerprint",
      "UserId": "2",
      "LogTime": "2020-09-17 07:48:22 GMT +0530"
    },
    "AuthToken": "COJJ7eiIPBGUfmIQPvh2PJWWDLX7OuKs",
    "Time": "2020-09-17 04:19:03 GMT +0000"
  }
}
Trường Thông tin máy chủ của bạn nhận được
OperationID Mã tham chiếu duy nhất cho sự kiện này
LabelName Tên địa điểm hoặc cửa mà thiết bị được gán
SerialNumber Thiết bị cụ thể đã ghi nhận lần quét
Type Đây là lượt vào hay lượt ra
InputType Người dùng đã xác minh bằng cách nào: vân tay, khuôn mặt, thẻ, mã PIN, v.v.
UserId Ai đã quét, khớp với ID trong hệ thống HR của bạn
LogTime Thời điểm quét xảy ra trên thiết bị, kèm độ lệch múi giờ
AuthToken Mã token để máy chủ của bạn xác nhận yêu cầu là hợp lệ
Time Dấu thời gian của chính thông điệp, theo GMT

Máy chủ của bạn phải gửi lại gì

Sau khi máy chủ nhận được sự kiện, nó trả về một thông báo xác nhận ngắn. Điều này cho Gateway biết sự kiện đã đến an toàn.

Callback API, phản hồi webhook của bạn phải trả về

{ "status": "done" }

Push, ngay cả khi thiết bị không thể

Không phải thiết bị nào cũng có thể tự đẩy dữ liệu. Một số thiết bị cũ hoặc chưa được xác minh chỉ lưu dữ liệu chấm công trong cơ sở dữ liệu cục bộ hoặc tệp. Với Cams Hybrid Push, Gateway có thể đọc từ cơ sở dữ liệu đó (DB Pull) hoặc theo dõi tệp đó (File Processing), và vẫn gửi các bản ghi chấm công mới đến Callback URL của bạn. Máy chủ của bạn nhận được dữ liệu theo kiểu push trong cả hai trường hợp, ngay cả khi thiết bị bên dưới bình thường cần được polling.

04 · Các thực hành tốt nhất

Xây dựng bộ tiếp nhận webhook đáng tin cậy

Bộ tiếp nhận webhook không khó xây dựng, nhưng một số thực hành sẽ tạo nên sự khác biệt giữa một hệ thống chỉ chạy được khi thử nghiệm và một hệ thống hoạt động ổn định hàng ngày trong nhiều năm.

Thực hành Nên làm gì Vì sao quan trọng
Xác nhận trước Trả về trạng thái done ngay khi nhận được sự kiện, sau đó mới xử lý các việc chậm hơn Giữ cho yêu cầu gửi từ Gateway ngắn gọn, ngay cả khi các hệ thống phía sau bạn chậm
Đưa công việc vào hàng đợi Đưa mỗi sự kiện nhận được vào hàng đợi hoặc bảng, rồi xử lý riêng Xử lý được các đợt dồn dập lúc đầu ca mà không làm rơi sự kiện
Kiểm tra AuthToken Kiểm tra token trong mọi yêu cầu trước khi tin dữ liệu Ngăn người khác gửi chấm công giả đến URL của bạn
Sử dụng HTTPS Chỉ mở webhook qua HTTPS, có thể bật mã hóa AES-256 tùy chọn từ Gateway Dữ liệu chấm công là dữ liệu cá nhân và phải được bảo vệ khi truyền tải
Đảm bảo xử lý idempotent Dùng OperationID để phát hiện và bỏ qua các sự kiện bạn đã xử lý Một lần gửi lặp lại không bao giờ tạo thành bản ghi chấm công trùng lặp
Tin cậy LogTime để chấm công Ghi nhận chấm công theo LogTime, không theo thời điểm máy chủ nhận được sự kiện Sự kiện được lưu trong thời gian gián đoạn sẽ đến muộn nhưng vẫn giữ đúng thời điểm quét thực tế
Sắp xếp theo LogTime Sắp xếp sự kiện theo LogTime trước khi tính số giờ Các sự kiện được lưu tạm có thể đến không đúng thứ tự sau khi bị rớt kết nối
Ghi nhật ký mọi thứ Lưu lại bản ghi của mọi sự kiện nhận được và mọi phản hồi đã gửi Giúp việc khắc phục sự cố và kiểm toán trở nên đơn giản

Lập kế hoạch cho các đợt cao điểm, không phải mức trung bình

Một địa điểm có 300 nhân viên có thể gần như không nhận được gì trong phần lớn thời gian của ngày, rồi nhận 300 sự kiện trong mười phút lúc đổi ca. Hãy thiết kế bộ tiếp nhận của bạn cho mức cao điểm đó. Xác nhận nhanh và đưa công việc vào hàng đợi là cách đơn giản nhất để xử lý.

Webhook có thể đặt ở đâu

Webhook của bạn cần một địa chỉ HTTPS công khai mà Gateway có thể truy cập. Đó có thể là một endpoint trong ứng dụng của bạn, một hàm đám mây nhỏ, hoặc một webhook đến trong công cụ tự động hóa như n8n hoặc Make. Bản thân thiết bị không cần IP công khai. Các địa điểm đặt sau tường lửa có thể kết nối với Gateway qua Hybrid Connector, công cụ hoạt động bằng kết nối đi ra ngoài.

Hệ thống của bạn quyết định bước tiếp theo

Gateway gửi các sự kiện đã xác minh và chờ xác nhận của bạn. Những gì xảy ra sau đó, chẳng hạn ghi vào HRMS, cập nhật bảng điều khiển, gửi thông báo đi muộn hoặc khởi động một quy trình làm việc, đều do phần mềm và quy tắc của bạn quyết định.

05 · Kết hợp cả hai

Polling vẫn có vị trí ở đâu

Webhook nên là lựa chọn mặc định cho dữ liệu sinh trắc học trực tiếp. Nhưng việc lấy dữ liệu theo yêu cầu vẫn có những công việc cụ thể và hữu ích. Các tích hợp mạnh nhất dùng webhook để gửi dữ liệu thời gian thực, và thỉnh thoảng lấy dữ liệu theo yêu cầu để kiểm tra và khôi phục.

Tình huống Cách tiếp cận tốt nhất Vì sao
Chấm công trực tiếp, bảng điều khiển, thông báo Webhook (Callback API) Dữ liệu đến ngay tại thời điểm quét
Máy chủ của bạn ngoại tuyến một khoảng thời gian Lấy log theo yêu cầu Lấp đầy mọi khoảng trống và xác nhận không bị bỏ sót
Đối soát hàng đêm hoặc hàng tuần Lấy log theo lịch So sánh với những gì webhook đã gửi, như một lưới an toàn
Thiết lập tích hợp mới Lấy log lịch sử một lần Nhập lịch sử hiện có trước khi webhook tiếp quản
Kiểm toán một khoảng thời gian cụ thể Lấy log cho khoảng thời gian đó Tạo bản ghi đầy đủ để xem xét

Với các công việc này, Cams RESTful API có các thao tác để tải log từ thiết bị. Khi được dùng có chủ đích và không thường xuyên, việc lấy log bổ sung cho webhook chứ không cạnh tranh với nó. Khác biệt nằm ở mục đích: bạn lấy dữ liệu khi có lý do, thay vì hỏi mỗi phút chỉ để phòng hờ.

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

Polling có bao giờ tốt hơn webhook cho dữ liệu sinh trắc học không?

Polling có thể đơn giản hơn khi hệ thống của bạn hoàn toàn không thể mở endpoint công khai nào, hoặc cho các lần nhập dữ liệu lịch sử một lần. Với dữ liệu chấm công và kiểm soát ra vào liên tục, webhook nhanh hơn, nhẹ hơn cho thiết bị và mạng, và dễ mở rộng qua nhiều địa điểm hơn.

Điều gì xảy ra với các lần quét nếu máy chủ webhook của tôi ngừng hoạt động?

Nếu máy chủ webhook của bạn ngừng hoạt động, dữ liệu chấm công sẽ được lưu trong hàng đợi của Cams. Khi máy chủ của bạn hoạt động trở lại, các bản ghi trong hàng đợi sẽ được tự động gửi đến máy chủ của bạn. Hàng đợi tự động khởi động lại mỗi 3 giờ một lần, và bạn cũng có thể khởi động lại thủ công bất cứ lúc nào từ Cams Portal. Điều này đảm bảo các bản ghi chấm công không bị mất do máy chủ tạm thời ngừng hoạt động.

Thiết bị sinh trắc học của tôi có cần IP công khai để webhook hoạt động không?

Không. URL webhook của bạn cần có thể được Gateway truy cập, nhưng thiết bị thì không. Các địa điểm không có IP công khai có thể kết nối qua Hybrid Connector, công cụ sử dụng kết nối đi ra ngoài.

Tôi có thể nhận webhook trong n8n, Make hoặc Zapier không?

Có. Bất kỳ công cụ nào có thể nhận webhook đến đều có thể nhận sự kiện Cams Callback. n8n và Make cũng có thể trả về trực tiếp xác nhận done cần thiết. Zapier có thể cần một lớp chuyển tiếp nhỏ phía trước để gửi phản hồi đó.

Vì sao LogTime và Time khác nhau trong payload?

LogTime là thời điểm người dùng thực sự quét, được ghi kèm độ lệch múi giờ của thiết bị. Time là dấu thời gian của chính thông điệp, theo GMT. Nếu thiết bị đang ngoại tuyến, thông điệp có thể được gửi muộn hơn nhiều so với lần quét. Luôn dùng LogTime để chấm công.

Kết luận: Hãy để chuông cửa reo

Polling có ý nghĩa khi thiết bị sinh trắc học chỉ có thể đọc theo yêu cầu và không ai kỳ vọng dữ liệu chấm công là trực tiếp. Ngày nay, bảng điều khiển nhân sự, hệ thống bảng lương, công cụ tự động hóa và trợ lý AI đều hoạt động tốt nhất khi có dữ liệu ngay khi nó phát sinh. Hỏi một thiết bị cùng một câu hỏi hàng nghìn lần mỗi ngày là cách chậm chạp và lãng phí để đạt được điều đó.

Webhook biến mỗi lần quét đã xác minh thành một sự kiện mà hệ thống của bạn nhận được ngay lập tức, không có yêu cầu thừa và không cần theo dõi mong manh những gì đã lấy về. Hãy giữ việc lấy log theo yêu cầu cho những gì nó làm tốt nhất, tức là lấp khoảng trống và kiểm tra tính đầy đủ, và để webhook đảm nhận phần còn lại.

Cams Biometrics Gateway được xây dựng xoay quanh việc gửi dữ liệu theo kiểu push. Callback API của nó gửi mọi lần quét đã xác minh đến webhook của bạn theo thời gian thực, từ các thiết bị của hơn 15 thương hiệu, theo một định dạng JSON thống nhất. Các chế độ Hybrid Push gửi sự kiện push ngay cả từ thiết bị không thể tự push, và RESTful API cung cấp các thao tác theo yêu cầu như tải log để đối soát. Mọi giao tiếp đều chạy qua HTTP/HTTPS với xác thực token và mã hóa AES-256 tùy chọn. Khám phá nền tảng tại CamsBiometrics.com và đọc tài liệu đầy đủ của Callback API tại developer.camsbiometrics.com.

Was this article helpful?