حسب ضرورت لائسنس API
Launch، Licentivo اور حسب ضرورت لائسنس خدمات کی حمایت کرتا ہے۔ سسٹم کی ترتیبات ← لائسنس سسٹم میں پوری دکان کے لیے ایک فراہم کنندہ منتخب کریں۔
حسب ضرورت لائسنس والی مصنوعات تاجر کی اپنی لائسنس خدمت اور SDK استعمال کرتی ہیں۔ Launch فروخت، ادائیگی کی تصدیق، خریداری کی حالت کی ہم آہنگی اور ترسیل کی معلومات سنبھالتا ہے۔
- sandbox اور live کے لیے کنکشن، دستخطی کلیدیں اور مصنوعات و منصوبوں کی میپنگ الگ ترتیب دیں۔ منصوبے شائع کرنے سے پہلے کنکشن جانچیں۔
- موجودہ آرڈرز والے کنکشن براہ راست تبدیل نہیں کیے جا سکتے۔ فراہم کنندہ بدلنے سے پہلے آرڈرز منتقل کریں، پھر منصوبے دوبارہ شائع کریں۔
- لائیو ترتیبات شائع کرنے سے پہلے آزمائشی ماحول میں خریداری، تجدید، اپ گریڈ، رقم کی واپسی اور خرابی سے بحالی کی جانچ کریں۔
تاجر کی لائسنس خدمت کے انٹرفیس
یہ چار انٹرفیس تاجر کی لائسنس خدمت نافذ کرتی ہے اور Launch سرور انہیں کال کرتا ہے۔ یہ درخواستیں www.licentivo.com کو نہ بھیجیں۔
| API | مقصد |
|---|---|
GET /launch/v1/capabilities | پروٹوکول، کنکشن، ماحول اور معاون خریداری و ترسیل کی اقسام بتائیں۔ |
POST /launch/v1/events | خریداری کا مکمل اسنیپ شاٹ وصول کریں اور ایونٹ مستقل محفوظ کرنے کے بعد رسید واپس کریں۔ |
GET /launch/v1/events/{event_id} | اصل ایونٹ کی رسید دریافت کریں۔ صرف applied سے لائسنس کی تبدیلی مکمل ہونے کی تصدیق ہوتی ہے۔ |
GET /launch/v1/entitlements/{entitlement_ref}/delivery | موجودہ خریداری ورژن کی پہلے سے موجود ترسیل پڑھیں؛ نیا لائسنس دوبارہ جاری نہ کریں۔ |
اسنیپ شاٹس میں خریداری کا ورژن، موجودہ حالت اور قطعی میعاد شامل ہوتی ہے؛ valid_until=null مستقل خریداری ظاہر کرتا ہے۔ رقم کی واپسی کے بعد بنیادی خریداری باقی رہ سکتی ہے، اس لیے وصول کنندہ مکمل اسنیپ شاٹ سے حقوق دوبارہ شمار کرے۔
{
"schema": "launch-external-licensing-v1",
"event_id": "7bf84b91-2749-4b01-a6a7-bd527c488ee8",
"connection_ref": "merchant-01-sandbox",
"environment": "sandbox",
"type": "entitlement.snapshot",
"change_reason": "purchase",
"account_ref": "customer_opaque_001",
"entitlement_ref": "purchase_opaque_001",
"launch_product_id": "c6dd463e-50f7-4b76-8239-0a8ec6fc304b",
"launch_plan_version_id": "5459a073-9362-4b46-949d-9b0c5d84421a",
"product_ref": "desktop-editor",
"plan_ref": "professional-yearly-v1",
"version": 1,
"desired_state": "active",
"valid_from": "2026-10-26T00:00:00Z",
"valid_until": "2027-10-26T00:00:00Z"
}دستخط اور دوبارہ کوشش
ہر کنکشن کے لیے کم از کم 32 بے ترتیب بائٹس کی الگ HMAC-SHA256 کلید رکھیں۔ درخواست میں کلید ID، سیکنڈوں میں Unix وقت، بے ترتیب nonce اور دستخط ہوں۔ دستخط، 300 سیکنڈ کی مدت اور nonce کے دوبارہ استعمال سے تحفظ کی جانچ کریں۔
v1
<key_id>
<timestamp>
<nonce>
<UPPERCASE HTTP METHOD>
<encoded full path and raw query>
<lowercase SHA-256 of the exact request body>دستخط کے ان پٹ کے آخر میں نئی سطر نہ لگائیں۔ X-Launch-Signature میں v1= کے بعد بغیر پیڈنگ کا base64url دستخط ہوتا ہے۔ GET کا باڈی خالی ہوتا ہے۔
دوبارہ کوشش میں ایونٹ ID اور اصل باڈی برقرار رکھیں، ہر مرتبہ نیا nonce استعمال کریں۔ ٹائم آؤٹ کے بعد پہلے اصل ایونٹ دریافت کریں۔ پرانا ورژن نئے کو تبدیل نہ کرے؛ 202 لائسنس لاگو ہونے کی تصدیق نہیں ہے۔
Launch انتظامیہ اور صارف کے انٹرفیس
یہ انٹرفیس تاجر کی اپنی Launch ویب سائٹ پر ہیں۔ منتظمین ویب سیشن اور X-CSRF-Token استعمال کرتے ہیں۔ صارف صرف اپنی موجودہ درست خریداری پڑھ سکتے ہیں۔
PUT /api/v1/admin/licensing/provider | {"provider":"custom_http"} |
GET/POST /api/v1/admin/licensing/connections | GET/POST |
PUT /api/v1/admin/licensing/connections/{id} | POST /api/v1/admin/licensing/connections/{id}/check |
PUT /api/v1/admin/products/{id}/licensing | environment + connection_id + mappings |
GET /api/v1/me/products/{id}/delivery?environment=sandbox | pending / ready / unavailable |
ترسیل میں لائسنس کلید، HTTPS ایکٹیویشن لنک یا سادہ متن کی ہدایات ہو سکتی ہیں۔ کامیاب ہم آہنگی کلائنٹ کے رن ٹائم اجازت کے معائنے کا بدل نہیں ہے۔
مکمل پروٹوکول اور مثالیں · OpenAPI ڈاؤن لوڈ کریں · Python وصول کنندہ کی مثال