परिचय
Cams Biometric Gateway — Web API 3.0
Cams Biometric Gateway एक यूनिवर्सल Biometric API है, जो किसी भी बायोमेट्रिक अटेंडेंस या एक्सेस कंट्रोल मशीन को आपके एप्लिकेशन से जोड़ता है — ERP, HRMS, पेरोल, स्कूल मैनेजमेंट, कस्टम सॉफ़्टवेयर या AI/ऑटोमेशन वर्कफ़्लो। यह सभी प्रमुख डिवाइस ब्रांड को सपोर्ट करता है और हार्डवेयर चाहे जो हो, एक मानकीकृत JSON-over-HTTP Biometric API उपलब्ध कराता है।
38 ऑपरेशन — 11 Callback API (डिवाइस → सर्वर) और 27 RESTful API (सर्वर → डिवाइस)। सभी पेलोड HTTP/HTTPS पर रॉ JSON में होते हैं।
सभी बायोमेट्रिक मशीनें समर्थित हैं। Cams मशीनें, सत्यापित डिवाइस और थर्ड-पार्टी ब्रांड (ZKTeco, Suprema, Hikvision, Anviz, Morpho/IDEMIA, Virdi, Mantra, Nitgen, Realtime/Startek, Biomax, Secugen, eSSL, Matrix COSEC, और अन्य)। अपने सेटअप के अनुकूल
कनेक्शन मोड चुनें।
यह कैसे काम करता है
Biometric Gateway में ये शामिल हैं:
Gateway सर्वरक्लाउड-होस्टेड प्लेटफ़ॉर्म, जिसमें Cams Protocol Engine (प्रोटोकॉल ट्रांसलेशन, डेटा नॉर्मलाइज़ेशन, ऑफ़लाइन कैशिंग, ऑथेंटिकेशन) और मानकीकृत API लेयर शामिल हैं, जो आपके एप्लिकेशन को एक समान इंटरफ़ेस देती है।
Protocol EngineGateway सर्वर का मुख्य इंजन, जो बायोमेट्रिक डिवाइस से संवाद करता है, वेंडर-विशिष्ट प्रोटोकॉल का अनुवाद करता है और सुरक्षित डेटा ट्रांज़ैक्शन लॉगिंग तथा आइडेंटिटी मैनेजमेंट संभालता है।
Protocol Engine Liteऑन-प्रिमाइस संस्करण, जिसे आप अपने सर्वर (Windows/Linux) पर इंस्टॉल कर सकते हैं — केवल LAN या सेल्फ़-होस्टेड परिवेश के लिए। वही API, स्थानीय रूप से डिप्लॉय।
इनके साथ इंटीग्रेट होता है
OdooERPNextSAPMicrosoft Dynamics
ZohoBitrix24
OrangeHRMBayZatPalmHRuKnowva
FedenaTeachmintEduBricz
RazorPayPayruler
n8nMakeZapier
Claude (MCP)GeminiChatGPT
कस्टम वेब ऐप्स
आपका एप्लिकेशन
ERP
HRMS
Payroll
स्कूल ERP
AI वर्कफ़्लो (n8n, Zapier)
MCP — Claude · Gemini · ChatGPT
कस्टम ऐप्स
Protocol Engine
सुरक्षित ऑथ प्रोसेसिंग
डेटा ट्रांज़ैक्शन लॉगिंग
प्रोटोकॉल ट्रांसलेशन
ऑफ़लाइन कैश & क्यू
AES-256 एन्क्रिप्शन · Auth Token वैलिडेशन
मानकीकृत API लेयर
आइडेंटिटी मैनेजमेंट
AI / MCP इंटीग्रेशन
Callback डिस्पैचर
REST कमांड राउटर
डेटा नॉर्मलाइज़ेशन · मल्टी-ब्रांड प्रोटोकॉल सपोर्ट
फ़िंगरप्रिंट
·
फ़ेस रिकग्निशन
·
पाम वेन
·
RFID कार्ड
·
PIN
·
QR / बारकोड
·
GPS ट्रैकिंग
बायोमेट्रिक डिवाइस — सभी ब्रांड समर्थित
Cams
ZKTeco
Suprema
Hikvision
Anviz
Morpho / IDEMIA
Virdi
Mantra
Nitgen
Realtime
Biomax
Secugen
eSSL
Matrix
+ और भी कई
| API प्रकार | दिशा | लेटेंसी | उपयोग |
|---|
| Callback API | डिवाइस → आपका सर्वर | रियल-टाइम / शून्य लेटेंसी | अटेंडेंस पंच और यूज़र सिंक इवेंट प्राप्त करें |
| RESTful API | आपका सर्वर → डिवाइस | ~15 सेकंड | यूज़र जोड़ें/हटाएँ, लॉग लोड करें, बायोमेट्रिक एनरोल करें |
परिचय
शुरुआत करें
तीन चरणों में इंटीग्रेट करें। Callback प्राप्त करने के लिए आपके सर्वर का सार्वजनिक रूप से पहुँच-योग्य URL होना चाहिए।
1
अपना Callback URL कॉन्फ़िगर करें
API Monitor पोर्टल में लॉग इन करें। अपने डिवाइस के लिए अपने सर्वर का सार्वजनिक HTTPS URL Callback URL के रूप में सेट करें। API इंजन बायोमेट्रिक इवेंट इसी एंडपॉइंट पर रियल-टाइम में POST करेगा।
2
अटेंडेंस पंच प्राप्त करें
आपके एंडपॉइंट को रॉ JSON बॉडी वाला POST मिलता है — Callback API के लिए किसी क्वेरी पैरामीटर की आवश्यकता नहीं है। AuthToken सत्यापित करें, पंच डेटा पार्स करें और {"status":"done"} से जवाब दें।
3
यूज़र और डिवाइस प्रबंधित करने के लिए RESTful API कॉल करें
अपने API Monitor खाते में दिए गए RESTful एंडपॉइंट URL पर JSON कमांड POST करें, क्वेरी पैरामीटर के रूप में अपना stgid (Service Tag ID) देते हुए। इंजन कमांड को कतार में रखता है और डिवाइस ~15 सेकंड में पुष्टि करता है।
एंडपॉइंट फ़ॉर्मेट
| API प्रकार | मेथड | कैसे भेजें |
|---|
| Callback API (इनबाउंड) |
POST |
डिवाइस आपके कॉन्फ़िगर किए URL पर पोस्ट करता है। रॉ JSON बॉडी; कोई पैरामीटर नहीं। |
| RESTful API (आउटबाउंड) |
POST |
आप RESTful एंडपॉइंट URL (अपने API Monitor खाते में उपलब्ध) पर ?stgid=YOUR_SERVICE_TAG_ID और रॉ JSON बॉडी के साथ POST करते हैं। |
Callback अनुरोधों का जवाब हमेशा तुरंत दें। प्राप्ति की पुष्टि के लिए आपके सर्वर को {"status":"done"} (HTTP 200) लौटाना होगा। जवाब देने से पहले भारी प्रोसेसिंग न करें — उसे कतार में डालें।
डॉक्यूमेंटेशन
API डॉक्यूमेंटेशन
रेफ़रेंस विषय के अनुसार बँटा है। पहले डिवाइस संगतता देखें, फिर callback और REST ऑपरेशन।
समर्थित डिवाइस और कनेक्शन मोडGateway कौन-सी मशीनें सपोर्ट करता है, प्रत्येक कैसे कनेक्ट होती है (Native Push या Hybrid Push) और हर मोड में कौन-से API ऑपरेशन उपलब्ध हैं।
API रेफ़रेंस: आर्किटेक्चर, फ़ील्ड और स्टेटस कोडहर ऑपरेशन में साझा बुनियादी तत्व: रिक्वेस्ट फ़्लो, सामान्य JSON फ़ील्ड, टेम्पलेट प्रकार, स्टेटस कोड, पोर्ट और पेलोड एन्क्रिप्शन।
Callback API: डिवाइस से आपके सर्वर तक रियल-टाइम इवेंटडिवाइस आपके callback URL पर जो भी इवेंट भेजता है, आपके सर्वर को मिलने वाले JSON और उसे लौटाए जाने वाले जवाब के साथ।
RESTful API: आपके सर्वर से डिवाइस को कमांडवे कमांड जो आपका सर्वर Gateway के माध्यम से डिवाइस को भेजता है, हर एक के रिक्वेस्ट और रिस्पॉन्स JSON के साथ।
API को लोकली टेस्ट करनाडिप्लॉय करने से पहले डेवलपमेंट मशीन पर डिवाइस callback कैसे प्राप्त करें और Postman से REST कमांड कैसे टेस्ट करें।
PHP उदाहरण: बायोमेट्रिक अटेंडेंस को MySQL में सहेजेंएक कार्यशील PHP callback हैंडलर, जो तीन चरणों में अटेंडेंस पंच को MySQL में सहेजता है।
AI कोड-जनरेटर प्रॉम्प्टअपने AI असिस्टेंट में प्रॉम्प्ट कॉपी करें और अपने स्टैक के लिए इंटीग्रेशन कोड जनरेट करें।
FAQ, SDK और लागतइंटीग्रेटर्स के सामान्य प्रश्न, साथ ही SDK और API मूल्य निर्धारण कैसे काम करते हैं।
