Support Hub/API & Integrations/การสร้างตัวรับ Callback ของระบบไบโอเมตริกซ์ด้วย Python,…
Translated from the English article and reviewed by a person. Read the English original
Developer

การสร้างตัวรับ Callback ของระบบไบโอเมตริกซ์ด้วย Python, Node.js และ PHP

การสร้างตัวรับ Callback ของระบบไบโอเมตริกซ์ด้วย Python, Node.js และ PHP

ตัวรับ Callback คือโค้ดขนาดเล็กที่เปลี่ยนทุกการสแกนลายนิ้วมือ ใบหน้า หรือบัตร ให้เป็นบันทึกในระบบของคุณเอง Cams Biometrics Gateway จะส่งการสแกนที่ได้รับการยืนยันแล้วแต่ละครั้งไปยังเซิร์ฟเวอร์ของคุณในรูปแบบคำขอ JSON และเซิร์ฟเวอร์ของคุณจะตอบกลับเพื่อยืนยันว่าได้รับข้อมูลแล้ว คุณไม่จำเป็นต้องเขียนตัวรับนี้ตั้งแต่ต้น Cams มีชุดคำสั่ง AI Code Generator Prompts สำหรับ Python, Node.js และ PHP เพียงคัดลอกคำสั่งไปวางในผู้ช่วย AI เช่น Claude หรือ ChatGPT คุณก็จะได้ไฟล์ที่ใช้งานได้ครบถ้วน ประกอบด้วยตัวรับ Callback, REST client และหน้าทดสอบ บทความนี้จะอธิบายว่าตัวรับต้องทำอะไรบ้าง วิธีสร้างตัวรับสำหรับภาษาที่คุณใช้ วิธีตั้งค่า และวิธีทดสอบก่อนนำไปใช้งานจริง

01 · หน้าที่ทั้งหกประการ

ตัวรับ Callback ต้องทำอะไรบ้าง

ไม่ว่าคุณจะใช้ภาษาใด ตัวรับ Callback ของระบบไบโอเมตริกซ์ทุกตัวต้องทำหน้าที่เหมือนกันทั้งหกประการ และนี่คือสิ่งที่ควรตรวจสอบในโค้ดใดก็ตามที่สร้างขึ้น

หน้าที่ ความหมาย เหตุผลที่สำคัญ
1. รับคำขอ รับ HTTP/HTTPS POST ที่มีเนื้อหา JSON แบบดิบ นี่คือวิธีที่ Gateway ส่งแต่ละเหตุการณ์
2. ตรวจสอบโทเค็น ตรวจสอบ AuthToken กับโทเค็น Callback ที่คาดหวัง ป้องกันไม่ให้ผู้อื่นส่งข้อมูลการเข้างานปลอมไปยัง URL ของคุณ
3. แยกการทำงานตามประเภทเหตุการณ์ ตรวจสอบว่าคีย์ใดอยู่ภายใน RealTime แล้วจัดการตามนั้น ไม่ใช่ทุก Callback จะเป็นการลงเวลา บางรายการรายงานรูปภาพหรือการเปลี่ยนแปลงข้อมูลผู้ใช้
4. ข้ามรายการซ้ำ ใช้ OperationID เพื่อละเว้นเหตุการณ์ที่บันทึกไว้แล้ว การส่งข้อมูลซ้ำจะไม่ทำให้เกิดบันทึกซ้ำสองรายการ
5. จัดเก็บและบันทึก Log บันทึกฟิลด์ที่ต้องการและบันทึก Log ของทุก Callback สร้างบันทึกที่ HRMS, ระบบเงินเดือน หรือแดชบอร์ดของคุณจะนำไปใช้
6. ตอบกลับว่าเสร็จสิ้น ส่งคืน {“status”:”done”} พร้อม HTTP 200 แจ้ง Gateway ว่าเหตุการณ์ได้รับเรียบร้อยแล้ว

02 · ทำความเข้าใจข้อมูลของคุณ

Payload ที่คุณจะได้รับ

Callback ที่พบบ่อยที่สุดคือบันทึกการลงเวลา ซึ่งจะถูกส่งทุกครั้งที่มีการสแกน บันทึกตัวอย่างนี้เป็น sample.json เพราะคุณจะใช้ไฟล์นี้ทดสอบตัวรับในภายหลัง

Callback API, คำขอ PunchLog ที่ส่งไปยังตัวรับของคุณ

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

หลังจากจัดการ Callback ใดๆ แล้ว ตัวรับของคุณต้องตอบกลับด้วย HTTP 200 และเนื้อหาตามนี้เท่านั้น:

Callback API, การตอบกลับที่ตัวรับของคุณต้องส่งคืน

{ "status": "done" } (HTTP 200)

ประเภทเหตุการณ์ของ Callback

Callback ทุกรายการจะมาในออบเจกต์ RealTime ตัวรับของคุณจะตัดสินใจว่าจะทำอะไรโดยตรวจสอบว่าคีย์ใดในรายการนี้มีอยู่:

คีย์ภายใน RealTime สิ่งที่รายงาน
PunchLog การสแกนเพื่อลงเวลาเข้างาน: ใคร เข้างานหรือออกงาน เมื่อไร และด้วยวิธีใด
UserUpdated ข้อมูลของผู้ใช้ได้รับการอัปเดตบนอุปกรณ์

สองรายละเอียดที่ทำให้นักพัฒนาพลาดได้บ่อย

รายละเอียด สิ่งที่ควรระวัง
คีย์ตอบกลับเป็นตัวพิมพ์เล็ก ส่งคืน status เป็นตัวพิมพ์เล็ก พร้อมค่า done อย่าคัดลอกฟิลด์ Status ที่ขึ้นต้นด้วยตัวพิมพ์ใหญ่จากการตอบกลับของ RESTful API
รูปแบบของ LogTime LogTime มีลักษณะเช่น 2020-09-17 07:48:22 GMT +0530 เป็นเวลาที่สแกนจริงพร้อมค่าออฟเซ็ตของอุปกรณ์ ให้แปลงค่าโดยใช้ออฟเซ็ตนั้นและนำไปใช้เป็นเวลาการลงเวลาเข้างาน

03 · ให้ AI เขียนโค้ด

สร้างตัวรับของคุณด้วย AI Code Generator Prompts

Cams เผยแพร่ไฟล์คำสั่งสำเร็จรูปสำหรับภาษาฝั่งเซิร์ฟเวอร์แต่ละภาษาที่รองรับ คำสั่งแต่ละชุดมีสรุปข้อกำหนดของ Cams Web API 3.0 และคำแนะนำที่ชัดเจนว่าต้องสร้างอะไร คุณเพียงวางคำสั่งลงในผู้ช่วย AI แล้วผู้ช่วยจะสร้างการทำงานแบบไฟล์เดียวที่สมบูรณ์สำหรับสแตกของคุณ

1

ดาวน์โหลดไฟล์คำสั่ง

เลือกภาษาของคุณในส่วนถัดไป แล้วดาวน์โหลดไฟล์คำสั่ง .txt ของภาษานั้น

2

วางในผู้ช่วย AI

เปิด Claude, ChatGPT, Copilot หรือเครื่องมือเขียนโค้ด AI ใดก็ได้ แล้ววางเนื้อหาคำสั่งทั้งหมด

3

รับไฟล์ที่ใช้งานได้ครบถ้วน

AI จะสร้างไฟล์เดียว ตั้งค่าการกำหนดค่าของคุณ นำไปติดตั้ง แล้วรันได้เลย

ไฟล์ที่สร้างแต่ละไฟล์ประกอบด้วย หน้าที่
ตัวรับ Callback อ่านเนื้อหา POST แบบดิบ ตรวจสอบ AuthToken แยกการทำงานตามประเภทเหตุการณ์ บันทึก Log ของทุก Callback จัดเก็บบันทึกการลงเวลา บันทึกรูปภาพการเข้างาน และตอบกลับว่าเสร็จสิ้น
REST client ฟังก์ชันคำขอทั่วไปพร้อมฟังก์ชันห่อหุ้มสำหรับการทำงาน RESTful ทั้ง 27 รายการ เช่น AddUser, DeleteUser, ResendAllUser และ UpdateAccessTime
หน้าทดสอบ HTML หน้าเว็บบนเบราว์เซอร์ที่มีช่องตั้งค่าของคุณ เมนูเลือกการทำงาน ตัวแก้ไข JSON ที่เติมเทมเพลตคำขอไว้ล่วงหน้า ตัวแสดงผลการตอบกลับ และรายการ Callback ล่าสุด

เอกสารออนไลน์มาเป็นอันดับแรก

คำสั่งแต่ละชุดจะบอก AI ให้อ่านเอกสาร Cams Web API ฉบับเต็ม และถือเป็นแหล่งข้อมูลหลักสำหรับการทำงาน โครงสร้าง JSON ชื่อฟิลด์ และรหัสการตอบกลับ หากสิ่งใดในสรุปของคำสั่งขัดแย้งกับเอกสารออนไลน์ ให้ยึดตามเอกสารเป็นหลัก

04 · เลือกภาษาของคุณ

คำสั่งสำหรับ Python, Node.js และ PHP

คำสั่งแต่ละชุดได้รับการปรับแต่งให้สร้างโค้ดที่เป็นไปตามแนวทางของภาษานั้นและมีการพึ่งพาน้อยที่สุด

Python

Flask, SQLite, ใช้เฉพาะ standard library

รับคำสั่ง Python

Node.js

Express, ที่จัดเก็บเป็นไฟล์ JSON

รับคำสั่ง Node.js

PHP

PHP ล้วน, SQLite, ไม่ใช้ Composer

ดาวน์โหลดคำสั่ง PHP

นอกจากนี้ยังมีคำสั่งสำหรับ C# (.NET 8) พร้อม Minimal API, Java พร้อม HttpServer ในตัวและไม่มีการพึ่งพาใดๆ, Go พร้อม net/http และ standard library เท่านั้น และ Ruby พร้อม Sinatra และ SQLite คุณสามารถค้นหาทั้งหมดได้ในส่วน AI Code Generator Prompts ของเอกสาร Cams Web API รับคำสั่ง.

05 · ค่าสามรายการที่ต้องตั้งค่า

การกำหนดค่าไฟล์ที่สร้างขึ้น

ไฟล์ที่สร้างขึ้นมีบล็อกการกำหนดค่าอยู่ด้านบน ในเวอร์ชัน PHP จะมีลักษณะดังนี้ และภาษาอื่นใช้ค่าสามรายการเดียวกัน:

บล็อกการกำหนดค่า เวอร์ชัน PHP

$CONFIG = [
    'base_url'            => 'https://YOUR_RESTFUL_ENDPOINT_URL',
    'stgid'               => 'YOUR_SERVICE_TAG_ID',
    'auth_token'          => 'YOUR_AUTH_TOKEN',
];
การตั้งค่า สิ่งที่ต้องกรอก
base_url URL ของ RESTful endpoint จากบัญชี Cams API Monitor ของคุณ
stgid Service Tag ID ของคุณ
auth_token AuthToken ของคุณ ซึ่งแนบไปกับคำขอ RESTful ขาออก และใช้ตรวจสอบกับ AuthToken ในคำขอ Callback ขาเข้า

เก็บโทเค็นให้พ้นจากโค้ดที่ใช้ร่วมกัน

สำหรับการทดสอบอย่างรวดเร็ว การพิมพ์ค่าลงในบล็อกการกำหนดค่าถือว่าใช้ได้ ก่อนนำไปใช้งานจริง ให้ย้ายโทเค็นไปไว้ในตัวแปรสภาพแวดล้อม (environment variables) หรือตัวจัดการความลับ (secrets manager) เพื่อไม่ให้โทเค็นไปอยู่ในระบบควบคุมเวอร์ชันหรือไฟล์ที่ใช้ร่วมกัน

เมื่อกำหนดค่าและติดตั้งที่ที่อยู่ HTTPS สาธารณะแล้ว ให้ตั้งค่าที่อยู่นั้นเป็น Callback URL ใน Cams Gateway หลังจากนั้น การสแกนที่ได้รับการยืนยันทุกครั้งจะถูกส่งมายังตัวรับของคุณแบบเรียลไทม์

06 · ทดสอบก่อนเชื่อมต่ออุปกรณ์

การทดสอบตัวรับของคุณ

คุณไม่จำเป็นต้องมีอุปกรณ์ไบโอเมตริกซ์เพื่อทดสอบตัวรับ Callback เพียงส่ง payload ตัวอย่างไปเองด้วย cURL โดยใช้โทเค็น Callback ที่ตรงกัน แล้วตรวจสอบการตอบกลับ

เทอร์มินัล, ส่ง Callback ทดสอบ

# Save the sample payload as sample.json, then send it to your receiver:
curl -X POST https://YOUR_SERVER/YOUR_CALLBACK_PATH \
  -H "Content-Type: application/json" \
  -d @sample.json

# Expected response (HTTP 200):
# {"status":"done"}
การทดสอบ สิ่งที่ต้องส่ง ผลลัพธ์ที่คาดหวัง
เหตุการณ์ที่ถูกต้อง sample.json โดยตั้งค่า AuthToken เป็น auth_token ของคุณ HTTP 200 พร้อม done และบันทึกการลงเวลาไว้
เหตุการณ์ซ้ำ คำขอเดิมส่งอีกครั้งเป็นครั้งที่สอง HTTP 200 พร้อม done และไม่มีการบันทึกรายการที่สองเพิ่ม
โทเค็นผิด sample.json ที่มี AuthToken ต่างออกไป ถูกปฏิเสธ และไม่มีการบันทึกใดๆ
เหตุการณ์เข้างาน sample.json ที่เปลี่ยน Type เป็น CheckIn บันทึกเป็นการเข้างาน
การทำงาน RESTful ใช้หน้าทดสอบ HTML ในตัวเพื่อส่งการทำงาน การตอบกลับที่มี Status และ StatusCode

หน้าทดสอบ HTML ที่สร้างขึ้นทำให้การทดลองฝั่ง RESTful ทำได้ง่าย เพียงเปิดไฟล์ในเบราว์เซอร์ เลือกการทำงานจากเมนู ปรับ JSON ที่เติมไว้ล่วงหน้า แล้วส่ง ส่วนตัวดูรายการ Callback ล่าสุดในหน้าเดียวกันจะยืนยันว่า Callback ทดสอบของคุณได้รับแล้ว

07 · รายการตรวจสอบก่อนใช้งานจริง

ตรวจสอบก่อนเปิดใช้งาน

โค้ดที่สร้างด้วย AI เป็นจุดเริ่มต้นที่รวดเร็วและเชื่อถือได้ แต่เช่นเดียวกับโค้ดทุกชนิด ควรได้รับการตรวจสอบก่อนนำไปจัดการข้อมูลพนักงานจริง

รายการ เสร็จสมบูรณ์เมื่อ
ตรวจสอบโค้drแล้ว นักพัฒนาได้อ่านไฟล์ที่สร้างขึ้นและเข้าใจว่าแต่ละส่วนทำอะไร
HTTPS เท่านั้น ตัวรับสามารถเข้าถึงได้ผ่าน HTTPS เท่านั้น และมีใบรับรองที่ถูกต้อง
โทเค็นได้รับการป้องกัน AuthToken ถูกจัดเก็บในตัวแปรสภาพแวดล้อมหรือตัวจัดการความลับ
จัดการรายการซ้ำแล้ว มีการจัดเก็บและตรวจสอบ OperationID เพื่อให้ข้ามการส่งซ้ำ
ระบบจัดเก็บเหมาะสม ที่จัดเก็บเป็นไฟล์ JSON เหมาะกับระบบขนาดเล็ก ระบบที่ใหญ่กว่าอาจย้ายไปใช้ฐานข้อมูลสำหรับการใช้งานจริง
หน้าทดสอบได้รับการป้องกัน หน้าทดสอบ HTML มีการป้องกันด้วยรหัสผ่านหรือปิดใช้งานบนเซิร์ฟเวอร์สาธารณะ
จัดการรูปภาพอย่างระมัดระวัง รูปภาพการเข้างานที่บันทึกลงดิสก์มีการควบคุมการเข้าถึง และเก็บไว้เท่าที่จำเป็นเท่านั้น
มีระบบติดตามตรวจสอบ ข้อผิดพลาดและปริมาณ Callback ที่ผิดปกติถูกบันทึกและแจ้งเตือนโดยระบบติดตามตรวจสอบของคุณเอง

เก็บกฎทางธุรกิจไว้ในระบบอื่น

หน้าที่ของตัวรับคือรับ ตรวจสอบ กำหนดเส้นทาง จัดเก็บ และตอบรับ การตัดสินว่าใครมาสาย การคำนวณค่าล่วงเวลา หรือการส่งการแจ้งเตือนเป็นหน้าที่ของระบบที่อ่านเหตุการณ์ที่จัดเก็บไว้ เช่น HRMS, ERP หรือเครื่องมืออัตโนมัติของคุณ ตัวรับที่มีหน้าที่เฉพาะจะปกป้องและดูแลรักษาได้ง่ายกว่า

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

ฉันจำเป็นต้องเขียนโค้ดเองหรือไม่

โดยทั่วไปไม่จำเป็น AI Code Generator Prompts จะสร้างไฟล์ที่ใช้งานได้ครบถ้วน คุณเพียงตั้งค่าสามรายการ นำไปติดตั้ง และทดสอบ อย่างไรก็ตาม นักพัฒนาควรตรวจสอบโค้ดก่อนใช้งานจริง

ผู้ช่วย AI ตัวใดใช้งานกับคำสั่งเหล่านี้ได้บ้าง

ผู้ช่วยเขียนโค้ด AI ที่มีความสามารถทุกตัว รวมถึง Claude, ChatGPT และ Copilot วางเนื้อหาคำสั่งทั้งหมดในครั้งเดียว เพื่อให้ผู้ช่วยมีข้อกำหนดครบถ้วน

ฉันจะหา RESTful endpoint URL และ Service Tag ID ได้จากที่ใด

ทั้งสองค่ามาจากบัญชี Cams API Monitor ของคุณ คำขอ RESTful จะถูกส่งไปยัง endpoint URL โดยตามด้วย ?stgid= และ Service Tag ID ของคุณ

ทำไมต้องตอบกลับ done สำหรับเหตุการณ์ซ้ำ

เพราะเหตุการณ์นั้นมาถึงอย่างปลอดภัยแล้ว แม้คุณจะบันทึกไว้ก่อนหน้านี้แล้วก็ตาม การตอบกลับ done จะบอก Gateway ว่าไม่จำเป็นต้องส่งอีกครั้ง

ฉันใช้ภาษาที่ไม่ได้ระบุไว้ได้หรือไม่

ได้ ตัวรับ Callback ต้องรับ HTTPS POST และส่งคืน JSON เท่านั้น คำสั่งเป็นเพียงทางลัด และ API เดียวกันนี้ใช้ได้กับภาษาใดก็ตามที่ทำสิ่งเหล่านี้ได้

สรุป: จากคำสั่งสู่การลงเวลาแบบเรียลไทม์ในหนึ่งบ่าย

ตัวรับ Callback ของระบบไบโอเมตริกซ์มีขนาดเล็ก แต่เป็นส่วนที่เปลี่ยนการสแกนที่ได้รับการยืนยันทุกครั้งให้เป็นข้อมูลสดสำหรับ HRMS ระบบเงินเดือน แดชบอร์ด และระบบอัตโนมัติของคุณ ด้วย Cams AI Code Generator Prompts คุณไม่จำเป็นต้องสร้างตั้งแต่ต้นอีกต่อไป ดาวน์โหลดคำสั่งสำหรับ Python, Node.js หรือ PHP วางในผู้ช่วย AI ตั้งค่าสามค่า แล้วทดสอบ จากนั้นตรวจสอบ ทำให้ปลอดภัย และปล่อยให้ข้อมูลการลงเวลาแบบเรียลไทม์เริ่มไหลเข้ามา

Cams Biometrics Gateway ส่งเหตุการณ์ที่ตัวรับของคุณต้องการ Callback API ส่งการสแกนที่ได้รับการยืนยันทุกครั้งแบบเรียลไทม์ ในรูปแบบ JSON ที่สอดคล้องกันเพียงรูปแบบเดียว จากอุปกรณ์มากกว่า 15 แบรนด์ และ RESTful API ของเรามี 27 การทำงานที่ client ที่สร้างขึ้นของคุณเรียกใช้ได้ การสื่อสารทั้งหมดทำงานผ่าน HTTP/HTTPS พร้อมการตรวจสอบ auth token และการเข้ารหัส AES-256 แบบเลือกใช้ สำรวจแพลตฟอร์มได้ที่ CamsBiometrics.com และอ่านเอกสาร Web API ฉบับเต็ม รวมถึง AI Code Generator Prompt ทั้งหมดได้ที่: รับคำสั่ง.

 

Was this article helpful?