Callback API: sự kiện thời gian thực từ thiết bị đến máy chủ của bạn

Mọi sự kiện thiết bị gửi đến callback URL của bạn, kèm JSON máy chủ nhận được và phản hồi cần trả về.

Callback API Thiết bị → Máy chủ của bạn · Thao tác 1–11

#01

ManuallyUserDeleted

Callback APIThiết bị → Máy chủ

Được kích hoạt khi người dùng bị xóa thủ công trực tiếp trên thiết bị. Chứa UserID và thời điểm xóa.

Yêu cầu — gửi đến máy chủ của bạn

{
  "RealTime": {
    "OperationID": "oy1kjign3sm7",
    "AuthToken": "COJJ7eiiPBGUfmIQPvh2PJWWDLX7OuKs",
    "Time": "2020-09-17 07:42:02 GMT +0000",
    "UserDeleted": {
      "UserID": "1",
      "OperationTime": "2020-09-17 13:12:02 GMT +0530"
    }
  }
}

Phản hồi — máy chủ của bạn phải trả về

{ "status": "done" }

#02

ManuallyDateModified

Callback APIThiết bị → Máy chủ

Được kích hoạt khi ngày/giờ của thiết bị bị thay đổi thủ công. Báo cáo giá trị mới được đặt.

Yêu cầu — gửi đến máy chủ của bạn

{
  "RealTime": {
    "OperationID": "1aci5f5o6kbi1",
    "AuthToken": "COJJ7eiiPBGUfmIQPvh2PJWWDLX7OuKs",
    "Time": "2020-09-17 07:52:31 GMT +0000",
    "DateModified": {
      "ModifiedTo": "2020-09-17 10:22:24 GMT +0530",
      "OperationTime": "2020-09-17 13:22:31 GMT +0530"
    }
  }
}

Phản hồi — máy chủ của bạn phải trả về

{ "status": "done" }

#03

ManuallyUserUpdatedWithoutTemplate

Callback APIThiết bị → Máy chủ

Hồ sơ người dùng (tên/loại) được cập nhật trên thiết bị — không thay đổi sinh trắc học. Mảng Template rỗng.

Yêu cầu — gửi đến máy chủ của bạn

{
  "RealTime": {
    "UserUpdated": {
      "UserID": "1",
      "FirstName": "jency",
      "LastName": "mary",
      "UserType": "User",
      "OperationTime": "2020-09-16 18:45:34 GMT +0530",
      "Template": []
    },
    "LabelName": "Burj Khalifa",
    "SerialNumber": "ZHM11xxxxxxxx",
    "OperationID": "1vsyboxnuuorq",
    "AuthToken": "COJJ7eiiPBGUfmIQPvh2PJWWDLX7OuKs",
    "Time": "2020-09-16 13:15:33 GMT +0000"
  }
}

Phản hồi — máy chủ của bạn phải trả về

{ "status": "done" }

#04

ManuallyUserUpdatedWithCard

Callback APIThiết bị → Máy chủ

Người dùng được cập nhật trên thiết bị kèm template thẻ/RFID. Data chứa số thẻ.

Yêu cầu — gửi đến máy chủ của bạn

{
  "RealTime": {
    "UserUpdated": {
      "UserID": "8", "FirstName": "", "LastName": "", "UserType": "User",
      "OperationTime": "2020-09-17 15:33:38 GMT +0530",
      "Template": [{ "Type": "Card", "UserID": "8", "Data": "9804445" }]
    },
    "LabelName": "Burj Khalifa",
    "SerialNumber": "ZHM11xxxxxxxx",
    "OperationID": "oldcu1ekxdbz",
    "AuthToken": "COJJ7eiiPBGUfmIQPvh2PJWWDLX7OuKs",
    "Time": "2020-09-17 10:03:38 GMT +0000"
  }
}

Phản hồi — máy chủ của bạn phải trả về

{ "status": "done" }

#05

ManuallyUserUpdatedWithPassword

Callback APIThiết bị → Máy chủ

Người dùng được cập nhật trên thiết bị kèm PIN/mật khẩu. Data là chuỗi PIN dạng số.

Yêu cầu — gửi đến máy chủ của bạn

{
  "RealTime": {
    "UserUpdated": {
      "UserID": "8", "FirstName": "", "LastName": "", "UserType": "User",
      "OperationTime": "2020-09-17 15:33:38 GMT +0530",
      "Template": [{ "Type": "Password", "UserID": "8", "Data": "124445" }]
    },
    "LabelName": "Burj Khalifa", "SerialNumber": "ZHM11xxxxxxxx",
    "OperationID": "oldcu1ekxdbz",
    "AuthToken": "COJJ7eiiPBGUfmIQPvh2PJWWDLX7OuKs",
    "Time": "2020-09-17 10:03:38 GMT +0000"
  }
}

Phản hồi — máy chủ của bạn phải trả về

{ "status": "done" }

#06

ManuallyUserUpdatedWithFingerPrint

Callback APIThiết bị → Máy chủ

Người dùng được cập nhật kèm vân tay. Index = vị trí ngón tay 0–9, Size = độ dài byte, Data = dữ liệu nhị phân Base64.

Yêu cầu — gửi đến máy chủ của bạn

{
  "RealTime": {
    "UserUpdated": {
      "OperationTime": "2020-09-17 12:48:28 GMT +0530",
      "Template": [{
        "Type": "Fingerprint", "UserID": "2",
        "Size": "1176", "Index": "6",
        "Data": "SjNTUzIxAAADcHcECAUHCc7Q..."
      }]
    },
    "LabelName": "Burj Khalifa", "SerialNumber": "ZHM11xxxxxxxx",
    "OperationID": "vq01h140jswo",
    "AuthToken": "COJJ7eiiPBGUfmIQPvh2PJWWDLX7OuKs",
    "Time": "2020-09-17 13:15:31 GMT +0000"
  }
}

Phản hồi — máy chủ của bạn phải trả về

{ "status": "done" }

#07

ManuallyUserUpdatedWithFace

Callback APIThiết bị → Máy chủ

Người dùng được cập nhật kèm template khuôn mặt. Data là JPEG mã hóa Base64 hoặc dữ liệu nhị phân khuôn mặt độc quyền (tùy thiết bị).

Yêu cầu — gửi đến máy chủ của bạn

{
  "RealTime": {
    "UserUpdated": {
      "OperationTime": "2020-09-17 19:04:55 GMT +0530",
      "Template": [{
        "Type": "Face", "UserID": "2",
        "Size": "28112", "Index": "0",
        "Data": "/9j/4AAQSkZJRgABAQAAAQABAAD..."
      }]
    },
    "LabelName": "Burj Khalifa", "SerialNumber": "ZHM11xxxxxxxx",
    "OperationID": "5qwmu986vm7c",
    "AuthToken": "COJJ7eiiPBGUfmIQPvh2PJWWDLX7OuKs",
    "Time": "2020-09-17 13:15:31 GMT +0000"
  }
}

Phản hồi — máy chủ của bạn phải trả về

{ "status": "done" }

#08

ManuallyUserUpdatedWithPalm

Callback APIThiết bị → Máy chủ

Người dùng được cập nhật kèm template tĩnh mạch lòng bàn tay. Data là dữ liệu nhị phân lòng bàn tay mã hóa Base64.

Yêu cầu — gửi đến máy chủ của bạn

{
  "RealTime": {
    "UserUpdated": {
      "OperationTime": "2020-09-17 19:10:12 GMT +0530",
      "Template": [{
        "Type": "Palm", "UserID": "2", "Index": "0",
        "Data": "apUBEOAHv98IAAwAAc/qAgzWDlDL..."
      }]
    },
    "LabelName": "Burj Khalifa", "SerialNumber": "ZHM11xxxxxxxx",
    "OperationID": "p3rm9kqx1yz0",
    "AuthToken": "COJJ7eiiPBGUfmIQPvh2PJWWDLX7OuKs",
    "Time": "2020-09-17 13:40:12 GMT +0000"
  }
}

Phản hồi — máy chủ của bạn phải trả về

{ "status": "done" }

#09

ManuallyUserUpdatedWithUserPhoto

Callback APIThiết bị → Máy chủ

Người dùng được cập nhật kèm ảnh hồ sơ. Data là JPEG mã hóa Base64.

Yêu cầu — gửi đến máy chủ của bạn

{
  "RealTime": {
    "UserUpdated": {
      "UserID": "5", "FirstName": "Alex", "LastName": "Thomas",
      "UserType": "User",
      "OperationTime": "2020-09-17 20:00:00 GMT +0530",
      "Template": [{ "Type": "UserPhoto", "UserID": "5", "Data": "/9j/4AAQSkZJRgABAQAAAQABAAD..." }]
    },
    "LabelName": "Burj Khalifa", "SerialNumber": "ZHM11xxxxxxxx",
    "OperationID": "up9h2bxk7q11",
    "AuthToken": "COJJ7eiiPBGUfmIQPvh2PJWWDLX7OuKs",
    "Time": "2020-09-17 14:30:00 GMT +0000"
  }
}

Phản hồi — máy chủ của bạn phải trả về

{ "status": "done" }

#10

RealTimeAttendancePhoto

Callback APIThiết bị → Máy chủ

Sự kiện chấm công thời gian thực kèm ảnh chụp (dành cho thiết bị có chụp ảnh). LogPhoto là JPEG mã hóa Base64.

Yêu cầu — gửi đến máy chủ của bạn

{
  "RealTime": {
    "Log": {
      "UserID": "3",
      "LogPhoto": "/9j/4AAQSkZJRgABAQAAAQABAAD...",
      "LogTime": "2020-09-17 07:48:30 GMT +0530"
    },
    "OperationID": "x58636uon24u",
    "AuthToken": "COJJ7eiiPBGUfmIQPvh2PJWWDLX7OuKs",
    "Time": "2020-09-17 04:19:18 GMT +0000"
  }
}

Phản hồi — máy chủ của bạn phải trả về

{ "status": "done" }

#11

RealTimePunchLog

Callback APIThiết bị → Máy chủ

Sự kiện chấm công thời gian thực chính — được kích hoạt ở mỗi lượt chấm công. Bao gồm loại, phương thức nhập, nhiệt độ và trạng thái khẩu trang.

Type: CheckIn · CheckOut · BreakOut · BreakIn · OverTimeIn · OverTimeOut · MealIn · MealOut | InputType: Fingerprint · Face · Palm · Card · Password

Yêu cầu — gửi đến máy chủ 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"
  }
}

Phản hồi — máy chủ của bạn phải trả về

{ "status": "done" }