واجهات Callback: أحداث لحظية من الجهاز إلى خادمك

كل حدث يرسله الجهاز إلى عنوان Callback الخاص بك، مع بيانات JSON التي يستقبلها خادمك والرد الذي يجب أن يعيده.

واجهات Callback من الجهاز إلى خادمك · العمليات 1–11

#01

ManuallyUserDeleted

واجهة Callbackالجهاز ← الخادم

يُطلق عند حذف مستخدم يدويًا مباشرة على الجهاز. يتضمن UserID ووقت الحذف.

الطلب — يُرسل إلى خادمك

{
  "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"
    }
  }
}

الاستجابة — يجب أن يعيدها خادمك

{ "status": "done" }

#02

ManuallyDateModified

واجهة Callbackالجهاز ← الخادم

يُطلق عند تغيير تاريخ/وقت الجهاز يدويًا. يبلغ عن القيمة الجديدة المضبوطة.

الطلب — يُرسل إلى خادمك

{
  "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"
    }
  }
}

الاستجابة — يجب أن يعيدها خادمك

{ "status": "done" }

#03

ManuallyUserUpdatedWithoutTemplate

واجهة Callbackالجهاز ← الخادم

تحديث ملف المستخدم (الاسم/النوع) على الجهاز — دون تغيير بيومتري. مصفوفة Template فارغة.

الطلب — يُرسل إلى خادمك

{
  "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"
  }
}

الاستجابة — يجب أن يعيدها خادمك

{ "status": "done" }

#04

ManuallyUserUpdatedWithCard

واجهة Callbackالجهاز ← الخادم

تحديث مستخدم على الجهاز بقالب بطاقة/RFID. يحمل Data رقم البطاقة.

الطلب — يُرسل إلى خادمك

{
  "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"
  }
}

الاستجابة — يجب أن يعيدها خادمك

{ "status": "done" }

#05

ManuallyUserUpdatedWithPassword

واجهة Callbackالجهاز ← الخادم

تحديث مستخدم على الجهاز برمز PIN/كلمة مرور. Data هي سلسلة PIN الرقمية.

الطلب — يُرسل إلى خادمك

{
  "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"
  }
}

الاستجابة — يجب أن يعيدها خادمك

{ "status": "done" }

#06

ManuallyUserUpdatedWithFingerPrint

واجهة Callbackالجهاز ← الخادم

تحديث مستخدم ببصمة. Index = موضع الإصبع 0–9، Size = الطول بالبايت، Data = بيانات ثنائية Base64.

الطلب — يُرسل إلى خادمك

{
  "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"
  }
}

الاستجابة — يجب أن يعيدها خادمك

{ "status": "done" }

#07

ManuallyUserUpdatedWithFace

واجهة Callbackالجهاز ← الخادم

تحديث مستخدم بقالب وجه. Data هي JPEG مرمّز بـ Base64 أو بيانات وجه ثنائية خاصة (بحسب الجهاز).

الطلب — يُرسل إلى خادمك

{
  "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"
  }
}

الاستجابة — يجب أن يعيدها خادمك

{ "status": "done" }

#08

ManuallyUserUpdatedWithPalm

واجهة Callbackالجهاز ← الخادم

تحديث مستخدم بقالب وريد راحة اليد. Data هي بيانات راحة اليد الثنائية المرمّزة بـ Base64.

الطلب — يُرسل إلى خادمك

{
  "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"
  }
}

الاستجابة — يجب أن يعيدها خادمك

{ "status": "done" }

#09

ManuallyUserUpdatedWithUserPhoto

واجهة Callbackالجهاز ← الخادم

تحديث مستخدم بصورة ملف شخصي. Data هي JPEG مرمّز بـ Base64.

الطلب — يُرسل إلى خادمك

{
  "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"
  }
}

الاستجابة — يجب أن يعيدها خادمك

{ "status": "done" }

#10

RealTimeAttendancePhoto

واجهة Callbackالجهاز ← الخادم

حدث بصمة لحظي مع لقطة ملتقطة (للأجهزة التي تدعم التقاط الصور). LogPhoto هي JPEG مرمّز بـ Base64.

الطلب — يُرسل إلى خادمك

{
  "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"
  }
}

الاستجابة — يجب أن يعيدها خادمك

{ "status": "done" }

#11

RealTimePunchLog

واجهة Callbackالجهاز ← الخادم

حدث الحضور اللحظي الأساسي — يُطلق عند كل بصمة. يتضمن النوع وطريقة الإدخال ودرجة الحرارة وحالة الكمامة.

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

الطلب — يُرسل إلى خادمك

{
  "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"
  }
}

الاستجابة — يجب أن يعيدها خادمك

{ "status": "done" }