HTTP Attendance API

अवलोकन

किसी भी क्लाइंट से उपस्थिति पंच, हार्टबीट और सब्सक्रिप्शन चेक लेने के लिए डिवाइस-निरपेक्ष HTTPS प्रवेश द्वार।

HTTP Attendance API, पाथ /api/attendance/v1/{op} पर डिवाइस-निरपेक्ष प्रवेश द्वार है। यह हर रिक्वेस्ट को डिवाइस सीरियल (sn) और auth-token हेडर से ऑथेंटिकेट करती है, फिर इन्जेस्ट करती है। यह punch (एक पहचाना गया उपस्थिति इवेंट), heartbeat (डिवाइस की मौजूदगी), validity (सब्सक्रिप्शन जाँच) और config उपलब्ध कराती है। पंच साझा पाइपलाइन में जाते हैं, जिससे नेटिव HTTP, TCP और MQTT ट्रांसपोर्ट जैसा ही स्टोरेज और डाउनस्ट्रीम कस्टमर-सर्वर पुश मिलता है — इसलिए उपस्थिति चाहे जैसे आए, इंटीग्रेशन एकसमान रहते हैं।

APIRESTHTTPSJSONC++

इनमें उपयोग:स्कूल, कॉलेज और कैंपस

POST /api/attendance/v1/punch

curl https://api.camsbiometrics.com/api/attendance/v1/punch \
  -H "sn: SN7A2300583" -H "auth-token: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "user_id":"1001", "att_time":"2026-06-21 09:30:00",
        "att_state":1, "input_type":50 }'
# -> 200 {"ok":true}

क्षमताएँ

यह क्या करता है

पंच इन्जेस्ट करें

यूज़र, टाइमस्टैम्प, IN/OUT स्थिति, इनपुट प्रकार और वैकल्पिक लोकेशन के साथ एक पहचाना गया उपस्थिति इवेंट POST करें।

मौजूदगी रिपोर्ट करें

बिना किसी बॉडी के, डिवाइस को ऑनलाइन चिह्नित करने के लिए हार्टबीट भेजें।

वैधता जाँचें

डेटा भेजने से पहले पूछें कि डिवाइस का उपस्थिति सब्सक्रिप्शन सक्रिय है या नहीं।

एकीकृत पाइपलाइन

हर पंच नेटिव TCP और MQTT इन्जेस्ट जैसे ही स्टोरेज और पुश पाथ में पहुँचता है।

फ़ीचर्स

सब कुछ शामिल

/api/attendance/v1/{op} पर एज, ऐप, वेब और हाइब्रिड क्लाइंट के लिए एकल HTTPS इन्ग्रेस
हेडर-आधारित ऑथ: डिवाइस सीरियल (sn) और auth-token, सब्सक्रिप्शन गेटिंग के साथ
punch endpoint पहचाना गया उपस्थिति इवेंट इन्जेस्ट करता है (यूज़र, समय, IN/OUT, इनपुट प्रकार, वैकल्पिक जियोलोकेशन)
heartbeat endpoint मौजूदगी ट्रैकिंग के लिए डिवाइस को ऑनलाइन चिह्नित करता है
validity endpoint क्लाइंट के डेटा भेजने से पहले लाइव सब्सक्रिप्शन स्थिति लौटाता है
साझा पाइपलाइन: नेटिव इंजनों जैसा ही स्टोरेज और कस्टमर-सर्वर पुश
सीरियल न होने, अज्ञात डिवाइस, अमान्य टोकन या निष्क्रिय सब्सक्रिप्शन के लिए एकसमान JSON एरर कॉन्ट्रैक्ट
nginx-फ़्रंटेड, बॉडी-साइज़ कैप और रेट लिमिटिंग के साथ