सॉफ़्टवेयर लाइसेंस API: सक्रियण, सत्यापन और हार्टबीट
भाषा और ऑपरेशन चुनकर SDK कॉल करें। यह सक्रियण, डिवाइस पहचान, हस्ताक्षर जाँच, कैश, हार्टबीट और उपयोग आरक्षण, पुष्टि व रद्द करना संभालता है।
Common scenario snippets
उदाहरण में client शुरुआत से आता है, path निर्यात पथ और exportReport / export_report आपका फ़ंक्शन है। उपयोग गणना का jobID ऐप में सहेजी गई स्थिर ID है।
पूरा कोड देखें → · त्वरित शुरुआत · उपयोग गणना का एकीकरण और पुनःप्रयास देखें →
SDK अनुमति मिलने पर ही कार्य चलाता है। RunFeature उपयोग नहीं काटता; RunMeteredFeature आरक्षण, सफलता पर पुष्टि और विफलता पर रद्द करता है। मूल कार्य से पुनःप्रयास केवल पुष्टि करता है, पूरा कार्य दोहराता नहीं।
Complete SDK method reference
The scenarios above are short call snippets. Below are the current language’s public methods, properties and utilities, including full signatures, parameters, results, errors, configuration and data fields. The reference follows the selected language and identifies capabilities that are unavailable in a wrapper.
HTTP अनुरोध और उत्तर खोलें (कस्टम क्लाइंट या समस्या जाँच)
नीचे का प्रोटोकॉल SDK में पहले से लागू है। इन नौ SDK का उपयोग करने वाले ऐप को इसे दोबारा लागू करने की आवश्यकता नहीं है।
आठ इंटरफ़ेस लाइसेंस और डिवाइस पहचान जाँचते हैं; लॉगिन कुकी, CSRF या प्रबंधन कुंजी नहीं चाहिए। निकलने पर फ्लोटिंग सत्र लौटता है; जुड़े डिवाइस का पंजीकरण रहता है।
सक्रियता, सत्यापन या हार्टबीट के बाद अनुमति कैसे जाँचें?
- HTTP 200 देखकर पढ़ें
data.activation_id। अगले सत्यापन, हार्टबीट, गणना और अनबाइंड में यह ID दें। - पहले से विश्वसनीय उत्पाद सार्वजनिक key से जाँचें
data.leaseजांचें, फिर उत्पाद, डिवाइस, वैधता और सुविधाएं मिलाएं। payload को JSON में पढ़ना भर लाइसेंस की वैधता सिद्ध नहीं करता। - SDK पहले दो चरण स्वयं करता है। RunFeature कार्य से पहले अनुमति जाँचता है; RunMeteredFeature गणना के आरक्षण, पुष्टि और रद्द करने को संभालता है।
SDK हस्ताक्षरित कैश रखता और नीति अनुसार हार्टबीट भेजता है। केवल टाइमआउट पर वैध कैश न मिटाएं। रद्द, रिलीज़ या समाप्ति की स्पष्ट अस्वीकृति पर SDK के परिणाम अनुसार संरक्षित सुविधाएं रोकें।
डिकोड payload फ़ील्ड का मतलब?
नीचे उदाहरण केवल डेटा समझाता है। स्वयं हस्ताक्षर जांचते समय मिले payload के मूल bytes लें; JSON को क्रम बदलकर या फिर serialize करके न जांचें।
दोबारा प्रयास, हार्टबीट व बिलिंग
सक्रियता, अनबाइंड व गणना में अनिवार्य Idempotency-Key, अधिकतम 80 अक्षर, बिना खाली स्थान। नए काम के लिए नया मान; उसी अनुरोध को दोहराने पर वही मान और body रखें। सत्यापन और हार्टबीट में वैकल्पिक; SDK अपने अनुरोध ID संभालता है।
अनुमति मान्य रहने पर एक जैसे सत्यापन और हार्टबीट अनुरोध एक घंटे तक दोबारा भेजने से दोहरा शुल्क नहीं लगता। इसके बाद नई अनुरोध कुंजी इस्तेमाल करें; पुरानी कुंजी को नया अनुरोध माना जा सकता है। सक्रियण, निष्क्रियकरण और सुविधा उपयोग के लिए स्थायी आइडेमपोटेंसी रिकॉर्ड रखे जाते हैं।
हर सफल सक्रियण, सत्यापन, हार्टबीट या हटाना एक API कॉल है। विफल और समान idempotent replay फिर नहीं गिने; CheckFeature स्थानीय है। Consume सुविधा उपयोग काटता, यह API सीमा नहीं; quantity उपयोग संख्या है।
हार्टबीट, ऑफ़लाइन अवधि व स्थायी अनुसार लाइसेंस नीतियाँ से नियंत्रित है।payload.expires_at मौजूदा हस्ताक्षरित कैश की समाप्ति है, लाइसेंस की अंतिम समाप्ति नहीं। अंतिम तिथि लाइसेंस विवरण में देखें।