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

فهرست گره‌ها با وضعیت و نسخه

GET 
/api/v1/admin/nodes

فهرست گره‌های ثبت‌شده را با وزن، تعداد کاربران سپرده‌شده، وضعیت مجوز و آخرین نسخه‌ای که هر سرویس گره گزارش داده برمی‌گرداند. این مسیر فقط خواندنی است.

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

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

پارامترها: page شماره‌ی صفحه است و از 1 شروع می‌شود (پیش‌فرض 1). pageSize پیش‌فرض ۵۰ و بیشینه ۲۰۰ است؛ مقدار بزرگ‌تر کوتاه نمی‌شود و پاسخ 400 با code: INVALID_PAGING برمی‌گرداند.

پاسخ: { "nodesListed", "maxNodes", "totalAssigned", "buildDate", "version", "commit", "total", "page", "pageSize", "nodes": [...] }. هر گره name، url، weight، usersAssigned، expectedShare، actualShare، licence و services (برای هر سرویس: service، lastBuildDate، version، commit، lastCallAt) دارد. totalAssigned و سهم‌ها همه‌ی گره‌ها را در بر می‌گیرند، نه فقط صفحه‌ی جاری.

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

درخواست​

پاسخ‌ها​

OK