Support Hub/API & Integrations/Python, Node.js और PHP में बायोमेट्रिक कॉलबैक रिसीवर बनाना
Translated from the English article and reviewed by a person. Read the English original
Developer

Python, Node.js और PHP में बायोमेट्रिक कॉलबैक रिसीवर बनाना

Python, Node.js और PHP में बायोमेट्रिक कॉलबैक रिसीवर बनाना

कॉलबैक रिसीवर वह छोटा-सा कोड है जो हर फ़िंगरप्रिंट, चेहरे या कार्ड स्कैन को आपके अपने सिस्टम में एक रिकॉर्ड में बदलता है। Cams Biometrics Gateway हर सत्यापित स्कैन को JSON अनुरोध के रूप में आपके सर्वर पर भेजता है, और आपका सर्वर यह पुष्टि करने के लिए जवाब देता है कि स्कैन पहुँच गया है। इस रिसीवर को आपको शुरू से लिखने की ज़रूरत नहीं है। Cams, Python, Node.js और PHP के लिए AI Code Generator Prompts उपलब्ध कराता है: इनमें से किसी एक को Claude या ChatGPT जैसे AI सहायक में पेस्ट करें, और आपको एक पूरी तरह काम करने वाली फ़ाइल मिल जाएगी, जिसमें कॉलबैक रिसीवर, REST क्लाइंट और एक टेस्ट इंटरफ़ेस शामिल होगा। यह ट्यूटोरियल बताता है कि रिसीवर को क्या करना होता है, अपनी भाषा के लिए उसे कैसे जनरेट करें, उसे कैसे कॉन्फ़िगर करें, और लाइव जाने से पहले उसकी जाँच कैसे करें।

01 · छह मुख्य काम

कॉलबैक रिसीवर को क्या करना होता है

आप किसी भी भाषा का उपयोग करें, हर बायोमेट्रिक कॉलबैक रिसीवर यही छह काम करता है। जनरेट किए गए किसी भी कोड में यही बातें जाँचें।

काम इसका मतलब यह क्यों ज़रूरी है
1. अनुरोध स्वीकार करें रॉ JSON बॉडी के साथ HTTP/HTTPS POST प्राप्त करें Gateway हर इवेंट इसी तरह भेजता है
2. टोकन सत्यापित करें AuthToken की जाँच अपने अपेक्षित कॉलबैक टोकन से करें किसी और को आपके URL पर नकली उपस्थिति भेजने से रोकता है
3. इवेंट प्रकार के अनुसार रूट करें देखें कि RealTime के अंदर कौन-सी key है और उसी के अनुसार कार्रवाई करें हर कॉलबैक पंच नहीं होता; कुछ फ़ोटो या उपयोगकर्ता में बदलाव की सूचना देते हैं
4. डुप्लिकेट छोड़ें OperationID का उपयोग करके उन इवेंट्स को अनदेखा करें जिन्हें आप पहले ही सेव कर चुके हैं दोहराया गया डिलीवरी कभी दोहरा रिकॉर्ड नहीं बनाता
5. सेव करें और लॉग करें आवश्यक फ़ील्ड सेव करें और हर कॉलबैक को लॉग करें वह रिकॉर्ड बनाता है जिसका उपयोग आपका HRMS, पेरोल या डैशबोर्ड करेगा
6. done के साथ जवाब दें HTTP 200 के साथ {“status”:”done”} लौटाएँ Gateway को बताता है कि इवेंट सुरक्षित पहुँच गया है

02 · अपने डेटा को जानें

वह पेलोड जो आपको मिलेगा

सबसे आम कॉलबैक एक पंच लॉग है, जो हर बार किसी के स्कैन करने पर भेजा जाता है। इस नमूने को 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"
  }
}

किसी भी कॉलबैक को संभालने के बाद, आपके रिसीवर को HTTP 200 और ठीक यही बॉडी लौटानी होगी:

Callback API, आपके रिसीवर द्वारा लौटाया जाने वाला जवाब

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

कॉलबैक इवेंट प्रकार

हर कॉलबैक एक RealTime ऑब्जेक्ट के अंदर आता है। आपका रिसीवर यह जाँचकर तय करता है कि क्या करना है कि इनमें से कौन-सी key मौजूद है:

RealTime के अंदर key यह क्या बताता है
PunchLog उपस्थिति स्कैन: कौन, चेक-इन या चेक-आउट, कब और किस तरीके से
UserUpdated डिवाइस पर किसी उपयोगकर्ता का विवरण अपडेट किया गया

दो विवरण जो डेवलपर्स को उलझा सकते हैं

विवरण किस बात पर ध्यान दें
जवाब की key छोटे अक्षरों में है status को छोटे अक्षरों में और मान done के साथ लौटाएँ। RESTful API जवाबों के बड़े अक्षरों वाले Status फ़ील्ड की नकल न करें
LogTime का फ़ॉर्मेट LogTime कुछ ऐसा दिखता है: 2020-09-17 07:48:22 GMT +0530। यह डिवाइस के offset के साथ असली स्कैन का समय है। इसे offset के साथ पार्स करें और उपस्थिति के समय के रूप में उपयोग करें

03 · कोड AI को लिखने दें

AI Code Generator Prompts से अपना रिसीवर जनरेट करें

Cams हर समर्थित सर्वर भाषा के लिए एक तैयार प्रॉम्प्ट फ़ाइल प्रकाशित करता है। हर प्रॉम्प्ट में Cams Web API 3.0 विनिर्देश का सारांश और यह बताने वाले स्पष्ट निर्देश होते हैं कि क्या बनाना है। आप इसे AI सहायक में पेस्ट करते हैं, और सहायक आपके स्टैक के लिए एक पूरा, एकल-फ़ाइल इम्प्लीमेंटेशन बना देता है।

1

प्रॉम्प्ट फ़ाइल डाउनलोड करें

अगले भाग में अपनी भाषा चुनें और उसकी .txt प्रॉम्प्ट फ़ाइल डाउनलोड करें।

2

इसे AI सहायक में पेस्ट करें

Claude, ChatGPT, Copilot, या कोई भी AI कोडिंग टूल खोलें और पूरी प्रॉम्प्ट सामग्री पेस्ट करें।

3

एक पूरी काम करने वाली फ़ाइल प्राप्त करें

AI एक एकल फ़ाइल जनरेट करता है। अपनी कॉन्फ़िगरेशन वैल्यू सेट करें, उसे डिप्लॉय करें और चलाएँ।

हर जनरेट की गई फ़ाइल में शामिल है यह क्या करता है
कॉलबैक रिसीवर रॉ POST बॉडी पढ़ता है, AuthToken को सत्यापित करता है, इवेंट प्रकार के अनुसार रूट करता है, हर कॉलबैक लॉग करता है, पंच लॉग सेव करता है, उपस्थिति की फ़ोटो सहेजता है, और done के साथ जवाब देता है
REST क्लाइंट एक सामान्य अनुरोध फ़ंक्शन, साथ ही सभी 27 RESTful operations के लिए रैपर फ़ंक्शन, जैसे AddUser, DeleteUser, ResendAllUser और UpdateAccessTime
HTML टेस्ट इंटरफ़ेस एक ब्राउज़र पेज जिसमें आपके कॉन्फ़िगरेशन फ़ील्ड, एक operation ड्रॉपडाउन, अनुरोध टेम्पलेट से पहले से भरा JSON एडिटर, एक जवाब व्यूअर और हाल के कॉलबैक की सूची है

पहले होस्ट किया गया दस्तावेज़ देखें

हर प्रॉम्प्ट AI को निर्देश देता है कि वह पूरे Cams Web API दस्तावेज़ को पढ़े और उसे operations, JSON schemas, फ़ील्ड नामों और response codes के लिए प्रामाणिक स्रोत माने। अगर प्रॉम्प्ट के सारांश में कोई बात होस्ट किए गए दस्तावेज़ से मेल नहीं खाती, तो दस्तावेज़ को प्राथमिकता मिलेगी।

04 · अपनी भाषा चुनें

Python, Node.js और PHP के लिए प्रॉम्प्ट

हर प्रॉम्प्ट को उस भाषा के लिए न्यूनतम dependencies के साथ idiomatic कोड बनाने के लिए तैयार किया गया है।

Python

Flask, SQLite, केवल standard library

Python प्रॉम्प्ट लें

Node.js

Express, JSON फ़ाइल स्टोर

Node.js प्रॉम्प्ट लें

PHP

शुद्ध PHP, SQLite, कोई Composer नहीं

PHP प्रॉम्प्ट डाउनलोड करें

प्रॉम्प्ट C# (.NET 8) के लिए Minimal API के साथ, Java के लिए बिल्ट-इन HttpServer और बिना किसी dependency के, Go के लिए केवल net/http और standard library के साथ, और Ruby के लिए Sinatra और SQLite के साथ भी उपलब्ध हैं। ये सभी Cams Web API दस्तावेज़ के AI Code Generator Prompts सेक्शन में मिल जाएँगे। प्रॉम्प्ट लें.

05 · तीन वैल्यू सेट करें

जनरेट की गई फ़ाइल को कॉन्फ़िगर करना

जनरेट की गई फ़ाइल के ऊपर एक कॉन्फ़िगरेशन ब्लॉक होता है। PHP संस्करण में यह ऐसा दिखता है, और बाकी भाषाओं में भी यही तीन वैल्यू इस्तेमाल होती हैं:

कॉन्फ़िगरेशन ब्लॉक, PHP संस्करण

$CONFIG = [
    'base_url'            => 'https://YOUR_RESTFUL_ENDPOINT_URL',
    'stgid'               => 'YOUR_SERVICE_TAG_ID',
    'auth_token'          => 'YOUR_AUTH_TOKEN',
];
सेटिंग क्या दर्ज करें
base_url आपके Cams API Monitor खाते से RESTful endpoint URL
stgid आपका Service Tag ID।
auth_token आपका AuthToken, जो आपके बाहर जाने वाले RESTful अनुरोधों में शामिल होता है और आने वाले कॉलबैक अनुरोधों के AuthToken से मिलाया जाता है।

टोकन को साझा कोड से बाहर रखें

त्वरित परीक्षण के लिए कॉन्फ़िगरेशन ब्लॉक में वैल्यू लिखना ठीक है। प्रोडक्शन से पहले टोकन को environment variables या secrets manager में ले जाएँ, ताकि वे कभी version control या किसी साझा फ़ाइल में न पहुँचें।

कॉन्फ़िगर करने और किसी सार्वजनिक HTTPS पते पर डिप्लॉय करने के बाद, उस पते को Cams Gateway में Callback URL के रूप में सेट करें। उसके बाद हर सत्यापित स्कैन रियल टाइम में आपके रिसीवर तक पहुँचेगा।

06 · डिवाइस जोड़ने से पहले जाँच करें

अपने रिसीवर की जाँच करना

कॉलबैक रिसीवर की जाँच करने के लिए आपको बायोमेट्रिक डिवाइस की ज़रूरत नहीं है। मिलते-जुलते कॉलबैक टोकन के साथ, cURL से नमूना पेलोड स्वयं भेजें और जवाब की जाँच करें।

टर्मिनल, टेस्ट कॉलबैक भेजें

# 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 के साथ, और कोई दूसरा रिकॉर्ड सेव नहीं होता
गलत टोकन अलग AuthToken वाला sample.json अस्वीकार किया जाता है, और कुछ भी सेव नहीं होता
चेक-इन इवेंट sample.json, जिसमें Type को CheckIn किया गया हो चेक-इन के रूप में सेव होता है
RESTful operation किसी operation को भेजने के लिए बिल्ट-इन HTML टेस्ट इंटरफ़ेस का उपयोग करें Status और StatusCode वाला जवाब

जनरेट किया गया HTML टेस्ट इंटरफ़ेस RESTful हिस्से को आज़माना आसान बनाता है: फ़ाइल को ब्राउज़र में खोलें, ड्रॉपडाउन से कोई operation चुनें, पहले से भरे JSON में ज़रूरत अनुसार बदलाव करें, और उसे भेजें। उसी पेज पर मौजूद हाल के कॉलबैक व्यूअर से पुष्टि होती है कि आपके टेस्ट कॉलबैक प्राप्त हुए हैं।

07 · प्रोडक्शन चेकलिस्ट

लाइव जाने से पहले समीक्षा करें

AI-जनरेट किया गया कोड एक तेज़ और भरोसेमंद शुरुआती बिंदु है, लेकिन किसी भी कोड की तरह, इसे असली कर्मचारी डेटा संभालने से पहले समीक्षा करनी चाहिए।

आइटम कब पूरा माना जाए
कोड की समीक्षा हो गई किसी डेवलपर ने जनरेट की गई फ़ाइल पढ़ ली है और समझ लिया है कि हर हिस्सा क्या करता है
केवल HTTPS रिसीवर केवल वैध certificate के साथ HTTPS पर ही पहुँचा जा सकता है
टोकन सुरक्षित AuthTokens environment variables या secrets manager में संग्रहीत हैं
डुप्लिकेट संभाले गए OperationID सेव और जाँचा जाता है, ताकि दोहराई गई डिलीवरी अनदेखी हो जाएँ
स्टोरेज उपयुक्त छोटे सेटअप के लिए JSON फ़ाइल स्टोर ठीक है; बड़े डिप्लॉयमेंट प्रोडक्शन डेटाबेस पर जा सकते हैं
टेस्ट इंटरफ़ेस सुरक्षित सार्वजनिक सर्वर पर HTML टेस्ट पेज पासवर्ड-सुरक्षित है या बंद है
फ़ोटो सावधानी से संभाली गईं डिस्क पर सेव की गई उपस्थिति की फ़ोटो तक पहुँच नियंत्रित है और उन्हें केवल ज़रूरत भर समय तक रखा जाता है
मॉनिटरिंग लागू त्रुटियाँ और असामान्य कॉलबैक संख्या लॉग होती हैं और आपकी अपनी मॉनिटरिंग उन पर अलर्ट देती है

व्यावसायिक नियम कहीं और रखें

रिसीवर का काम स्वीकार करना, सत्यापित करना, रूट करना, सेव करना और पावती देना है। यह तय करना कि कौन देर से आया, ओवरटाइम की गणना करना, या नोटिस भेजना उन सिस्टम का काम है जो सेव किए गए इवेंट पढ़ते हैं, जैसे आपका HRMS, ERP, या automation tools। एक केंद्रित रिसीवर को सुरक्षित रखना और बनाए रखना आसान होता है।

अक्सर पूछे जाने वाले प्रश्न

क्या मुझे खुद कोई कोड लिखना होगा?

आमतौर पर नहीं। 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 को पता चलता है कि उसे इसे दोबारा भेजने की ज़रूरत नहीं है।

क्या मैं ऐसी भाषा का उपयोग कर सकता हूँ जो सूची में नहीं है?

हाँ। कॉलबैक रिसीवर को बस HTTPS POST स्वीकार करना और JSON लौटाना होता है। प्रॉम्प्ट एक शॉर्टकट हैं, और वही API ऐसी किसी भी भाषा के साथ काम करता है जो यह कर सकती है।

निष्कर्ष: एक दोपहर में प्रॉम्प्ट से रियल-टाइम उपस्थिति तक

बायोमेट्रिक कॉलबैक रिसीवर छोटा होता है, लेकिन यही वह हिस्सा है जो हर सत्यापित स्कैन को आपके HRMS, पेरोल, डैशबोर्ड और automations के लिए लाइव डेटा में बदलता है। Cams AI Code Generator Prompts के साथ आपको इसे खाली पन्ने से बनाने की ज़रूरत नहीं है। Python, Node.js या PHP के लिए प्रॉम्प्ट डाउनलोड करें, उसे अपने AI सहायक में पेस्ट करें, तीन वैल्यू सेट करें और जाँचें। फिर उसकी समीक्षा करें, उसे सुरक्षित करें, और रियल-टाइम उपस्थिति डेटा को बहना शुरू होने दें।

Cams Biometrics Gateway आपके रिसीवर के लिए ज़रूरी इवेंट भेजता है। इसका Callback API हर सत्यापित स्कैन को रियल टाइम में, एक समान JSON फ़ॉर्मेट में, 15 से अधिक ब्रांड के डिवाइसों से भेजता है, और इसका RESTful API 27 operations देता है, जिन्हें आपका जनरेट किया गया क्लाइंट कॉल कर सकता है। सारा संचार auth token सत्यापन और वैकल्पिक AES-256 एन्क्रिप्शन के साथ HTTP/HTTPS पर चलता है। प्लेटफ़ॉर्म को CamsBiometrics.com पर देखें, और हर AI Code Generator Prompt सहित पूरा Web API दस्तावेज़ पढ़ें: प्रॉम्प्ट लें.

 

Was this article helpful?