होम / API रेफ़रेंस

Biometric Gateway API

हर डिवाइस के लिए एक कॉन्ट्रैक्ट। पाँच क्षमता समूहों में 38 ऑपरेशन, सिंक्रोनस REST कॉल और रियल-टाइम Callback webhooks के रूप में उपलब्ध।

🌐

Base URL

सभी REST कॉल एक ही वर्ज़न वाले होस्ट पर की जाती हैं।

https://api.camsbiometrics.com/v3/

🔑

ऑथेंटिकेशन

हर रिक्वेस्ट में आपके अकाउंट और डिवाइस तक सीमित AuthToken होती है। की डेवलपर पोर्टल से जारी की जाती हैं।

📦

फ़ॉर्मेट

फ़ॉर्म-एन्कोडेड या JSON रिक्वेस्ट। रिस्पॉन्स JSON में होते हैं, जिनमें फ़ील्ड और एरर कोड अनुमानित होते हैं।

इंटीग्रेट करने के दो तरीके

REST जब आप पूछें। Callback जब कुछ हो।

REST

रिक्वेस्ट / रिस्पॉन्स

आप गेटवे को कॉल करते हैं और तुरंत जवाब पाते हैं। उपस्थिति लाने, यूज़र्स की सूची बनाने, किसी को एनरोल करने या ज़रूरत पर दरवाज़ा खोलने के लिए एकदम सही।

  • सिंक्रोनस और अनुमानित
  • सिंक, रिपोर्ट और एडमिन कार्रवाइयों के लिए बेहतरीन
  • किसी भी भाषा या cURL से काम करता है
CALLBACK

रियल-टाइम webhooks

एक URL रजिस्टर करें और डिवाइस के रिपोर्ट करते ही गेटवे इवेंट आपको पुश करता है — बिना पोलिंग, विफलता पर स्वचालित रीट्राई के साथ।

  • तुरंत उपस्थिति और स्टेटस इवेंट
  • न cron जॉब, न छूटे पंच
  • जब तक आपका endpoint पावती न दे, रीट्राई होते रहते हैं

ऑपरेशन

सभी 38 ऑपरेशन

काम के अनुसार समूहित। नाम गेटवे के मूल endpoints से 1:1 मेल खाते हैं।

📊

उपस्थिति · 8

GET
GetAttendanceByDate

पूरे अकाउंट में किसी तारीख़ सीमा के सभी पंच।

GET
GetAttendanceByEmployee

किसी एक कर्मचारी कोड के लिए एक अवधि के लॉग।

GET
GetAttendanceByDevice

एक डिवाइस सीरियल नंबर द्वारा कैप्चर किए गए पंच।

GET
GetAttendanceSummary

प्रति-दिन, प्रति-कर्मचारी सारांश (इन/आउट, घंटे)।

GET
GetFirstInLastOut

प्रति कर्मचारी प्रति दिन फ़र्स्ट-इन / लास्ट-आउट जोड़ी।

GET
GetTodayAttendance

आज के पंच का लाइव स्नैपशॉट।

GET
GetAttendancePhoto

पंच के साथ जुड़ी कैप्चर की गई फ़ोटो, जहाँ समर्थित हो।

GET
ExportAttendance

पेरोल और रिकंसिलिएशन के लिए बल्क एक्सपोर्ट।

👤

यूज़र्स और एनरोलमेंट · 12

POST
AddUser

एक या अधिक डिवाइसों पर यूज़र बनाएँ।

POST
UpdateUser

नाम, रोल, वैधता या विशेषाधिकार संपादित करें।

POST
DeleteUser

किसी डिवाइस से यूज़र हटाएँ।

GET
FindUser

कोड से यूज़र खोजें, वैकल्पिक क्रेडेंशियल के साथ।

GET
ListUsers

किसी डिवाइस पर एनरोल सभी लोगों की सूची।

GET
ListUserDevices

दिखाएँ कि यूज़र किन डिवाइसों पर मौजूद है।

POST
EnrollFingerprint

डिवाइस पर फ़िंगरप्रिंट टेम्पलेट पुश करें।

POST
EnrollFace

फ़ेस टेम्पलेट रजिस्टर करें, जहाँ समर्थित हो।

POST
EnrollCard

यूज़र को RFID / प्रॉक्सिमिटी कार्ड असाइन करें।

POST
SetUserPassword

डिवाइस PIN / पासवर्ड सेट या बदलें।

POST
CopyUsers

डिवाइसों के बीच यूज़र्स और टेम्पलेट क्लोन करें।

POST
ResendUser

यूज़र का डेटा डिवाइस क्यू में फिर से भेजें।

🔒

एक्सेस कंट्रोल · 5

POST
OpenDoor

डोर रिले, टर्नस्टाइल, फ़्लैप, स्विंग या बूम बैरियर को रियल टाइम में ट्रिगर करें।

POST
LockDoor

दरवाज़े को अपने नियंत्रण में लॉक / होल्ड करें।

GET
GetDoorStatus

वर्तमान खुली / बंद स्थिति पढ़ें।

POST
SetAccessSchedule

समय-आधारित एक्सेस विंडो परिभाषित करें।

GET
GetAccessEvents

एंट्री / एग्ज़िट और दरवाज़े के इवेंट का लॉग।

📡

डिवाइस मैनेजमेंट · 8

GET
ListDevices

हर जुड़े डिवाइस की इन्वेंटरी।

GET
GetDeviceInfo

मॉडल, फ़र्मवेयर, क्षमता और काउंटर।

GET
CheckDeviceHealth

ऑनलाइन स्थिति, अंतिम बार देखा गया और क्यू की गहराई।

GET
PingConnection

अभी किसी डिवाइस की पहुँच की पुष्टि करें।

POST
SyncDeviceTime

डिवाइस की घड़ी को सर्वर के साथ मिलाएँ।

POST
RebootDevice

डिवाइस को दूर से रीस्टार्ट करें।

POST
ResetDeviceQueue

क्यू से अटके कमांड साफ़ करें।

GET
GetCommandStatus

क्यू में रखे कमांड की स्थिति ट्रैक करें।

🔌

रियल-टाइम, callback और सिस्टम · 5

POST
RegisterCallback

लाइव इवेंट के लिए webhook URL सब्सक्राइब करें।

PUSH
attendance.new

हर पंच पर रियल टाइम में ट्रिगर होता है।

PUSH
device.status

ऑनलाइन / ऑफ़लाइन और हेल्थ में बदलाव।

PUSH
enrollment.update

टेम्पलेट के डिवाइस पर पहुँचने की पुष्टि।

GET
MigrationStatus

बल्क डिवाइस / डेटा माइग्रेशन की प्रगति ट्रैक करें।

अनुमानित रिस्पॉन्स

स्टेटस कोड जिन पर आप स्विच कर सकें

कोडअर्थक्या करें
200सफलJSON पेलोड प्रोसेस करें।
401AuthToken अमान्य या अनुपस्थितAPI की और डिवाइस पेयरिंग जाँचें।
404डिवाइस या यूज़र नहीं मिलासीरियल नंबर / कर्मचारी कोड सत्यापित करें।
409डिवाइस ऑफ़लाइन / क्यू मेंकमांड क्यू में है; GetCommandStatus पोल करें।
429रेट लिमिट लागूरुकें और जिटर के साथ दोबारा कोशिश करें।

अपना पहला endpoint कॉल करने के लिए तैयार हैं?

क्विकस्टार्ट आपको API की से लेकर पहले उपस्थिति लॉग तक मिनटों में पहुँचाता है।