پرش به مطلب اصلی

نصب فایل مجوز تازه

POST 
/api/v1/licence

یک فایل مجوز تازه را روی سرور سراسری نصب می‌کند. فایل پیش از نصب کامل بررسی می‌شود و فایل ردشده هرگز جای مجوز فعلی را نمی‌گیرد.

این درخواست مستقیم به سرور سراسری (اصلی) فرستاده می‌شود، یعنی https://nb.<base-domain>، نه به نشانی گره.

دسترسی: فقط مدیر سامانه. توکن باید توکن کاربر باشد (نه توکن client-credentials) و نقش admin داشته باشد. بدون توکن پاسخ 401 و برای کاربر بدون نقش admin پاسخ 403 است.

بدنه‌ی درخواست: متن فایل .lic به یکی از این سه شکل: بدنه‌ی خام با Content-Type: text/plain، multipart/form-data (اولین فایل، یا فیلد فرم licence)، یا JSON به شکل { "licence": "..." }. حداکثر اندازه‌ی درخواست ۶۴ کیلوبایت است.

پاسخ: 200 با { "warnings": [...], "status": {...} }. warnings هشدارهایی مانند گره‌های فعالی است که مجوز نامشان را نبرده؛ status همان شکل پاسخ GET /api/v1/licence/status است.

خطاها: 400 با { "code": "LICENCE_REJECTED", "check", "reason", "status" } وقتی فایل رد شود؛ check نام بررسیِ ناموفق است. بدنه‌ی خالی هم 400 با check: Decode می‌دهد.

نکته: این مسیر حتی وقتی مجوز معتبر نیست یا منقضی شده پاسخ می‌دهد.

پاسخ‌ها​

OK