سافٹ ویئر لائسنس API: فعالیت، تصدیق اور ہارٹ بیٹ

زبان اور کارروائی منتخب کرکے SDK کال کریں۔ یہ ایکٹیویشن، ڈیوائس شناخت، دستخط کی تصدیق، کیش، ہارٹ بیٹ اور استعمال کی بکنگ، تصدیق و منسوخی سنبھالتا ہے۔

آغاز یا فعال سازی کی سکرینبامعاوضہ خصوصیت سے پہلےایپ سے نکلنے پر

Common scenario snippets

مثالوں میں client آغاز سے آتا ہے، path برآمد کا راستہ اور exportReport / export_report آپ کا فنکشن ہے۔ گنتی کا jobID ایپ میں محفوظ مستقل ID ہے۔

مکمل کوڈ دیکھیں ← · فوری آغاز · گنتی والے انضمام اور دوبارہ کوشش دیکھیں ←

کاروباری کوڈ callback میں رکھیں۔

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 کو استعمال کرنے والی ایپس کو اسے دوبارہ نافذ کرنے کی ضرورت نہیں۔

پہلی فعال کاریاجرا کا heartbeatاصل کام سے پہلے اجازت جانچیںآلہ بدلنے سے پہلے علیحدگی

آٹھ انٹرفیس لائسنس اور آلے کی شناخت جانچتے ہیں؛ لاگ ان کوکی، CSRF یا انتظامی کلید نہیں چاہیے۔ اختتام پر فلوٹنگ سیشن چھوڑا جاتا ہے؛ منسلک آلے کا اندراج رہتا ہے۔

activation، تصدیق یا heartbeat کے بعد اجازت کیسے جانچیں؟

HTTP 200 دیکھ کر پڑھیں data.activation_id۔ آئندہ تصدیق، heartbeat، گنتی اور علیحدگی میں یہ ID دیں۔
پہلے معتبر پروڈکٹ public key سے تصدیق data.lease کی تصدیق کے بعد پروڈکٹ، آلہ، میعاد اور خصوصیات ملائیں۔ صرف payload کو JSON میں پڑھنا لائسنس کی صحت ثابت نہیں کرتا۔
SDK پہلے دو مرحلے خود کرتا ہے۔ RunFeature کارروائی سے پہلے اجازت جانچتا ہے؛ RunMeteredFeature گنتی کی بکنگ، تصدیق اور منسوخی سنبھالتا ہے۔

SDK دستخط شدہ cache رکھتا اور پالیسی کے مطابق heartbeat بھیجتا ہے۔ صرف timeout پر درست cache نہ مٹائیں۔ واضح منسوخی، release یا میعاد ختم ہونے پر SDK کے نتیجے کے مطابق محفوظ خصوصیات روکیں۔

decoded payload فیلڈ کا مطلب؟

نیچے مثال صرف ڈیٹا سمجھانے کے لیے ہے۔ خود دستخط جانچتے وقت موصولہ payload کے اصل bytes لیں؛ JSON کو دوبارہ ترتیب یا serialize نہ کریں۔

دوبارہ کوشش، heartbeat اور بلنگ

activation، علیحدگی اور گنتی میں لازم Idempotency-Key، زیادہ سے زیادہ 80 حروف، بغیر خالی جگہ۔ نئی کارروائی کے لیے نئی قدر؛ اسی کارروائی کی retry میں اصل قدر اور body رکھیں۔ validation اور heartbeat میں اختیاری؛ SDK اپنے request ID سنبھالتا ہے۔

اجازت مؤثر رہنے تک ایک جیسے تصدیقی اور ہارٹ بیٹ درخواستیں ایک گھنٹے کے اندر دوبارہ بھیجنے پر دوہری فیس نہیں لگتی۔ اس مدت کے بعد نئی درخواست کی کلید استعمال کریں؛ پرانی کلید کو نئی درخواست سمجھا جا سکتا ہے۔ فعالیت، غیرفعالیت اور خصوصیات کے استعمال کے لیے تکرار سے بچاؤ کے مستقل ریکارڈ محفوظ رہتے ہیں۔

ہر کامیاب activation، validation، heartbeat یا unbind ایک API کال ہے۔ ناکام یا idempotent replay دوبارہ نہیں گنتا؛ CheckFeature مقامی ہے۔ Consume خصوصیت استعمال کم کرتا، API کوٹا نہیں؛ quantity استعمال کی مقدار ہے۔

heartbeat، آف لائن مدت، permanent مطابق لائسنس پالیسیاں سے کنٹرول ہے۔payload.expires_at موجودہ دستخط شدہ cache کی میعاد ہے، لائسنس کی آخری میعاد نہیں۔ آخری تاریخ لائسنس تفصیل میں دیکھیں۔