การสร้างตัวรับ 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 แล้วผู้ช่วยจะสร้างการทำงานแบบไฟล์เดียวที่สมบูรณ์สำหรับสแตกของคุณ
|
ดาวน์โหลดไฟล์คำสั่ง เลือกภาษาของคุณในส่วนถัดไป แล้วดาวน์โหลดไฟล์คำสั่ง .txt ของภาษานั้น |
|
|
วางในผู้ช่วย AI เปิด Claude, ChatGPT, Copilot หรือเครื่องมือเขียนโค้ด AI ใดก็ได้ แล้ววางเนื้อหาคำสั่งทั้งหมด |
|
|
รับไฟล์ที่ใช้งานได้ครบถ้วน 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
คำสั่งแต่ละชุดได้รับการปรับแต่งให้สร้างโค้ดที่เป็นไปตามแนวทางของภาษานั้นและมีการพึ่งพาน้อยที่สุด
|
|
|
นอกจากนี้ยังมีคำสั่งสำหรับ 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 ทั้งหมดได้ที่: รับคำสั่ง.