یافتن گره

یک استقرار ابردرایو می‌تواند چند گره (سرور ذخیره‌سازی) داشته باشد و فایل‌های هر کاربر فقط روی یکی از آن‌ها نگه داشته می‌شود. هر گره دروازه‌ی API خودش را دارد، با نشانی‌ای مثل https://apigateway.n2.<domain>. همه‌ی درخواست‌های /api/v1/... این مستندات باید به دروازه‌ی گره‌ی همان کاربر فرستاده شوند.

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

درخواست

پس از ورود، با همان توکن و ایمیل کاربر واردشده:

curl -X POST "https://nb.<domain>/Selection/Assign/ali@example.com" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

ایمیل در مسیر باید دقیقاً با ادعای email توکن یکی باشد؛ در غیر این صورت پاسخ 401 است. بدنه‌ی درخواست خالی است.

پاسخ

{
  "url": "https://apigateway.n2.example.com",
  "companionUrl": "https://companion.n2.example.com",
  "name": "n2"
}

• url: نشانی پایه‌ی دروازه‌ی API. مسیرهای مرجع را به آن بچسبانید، مثلاً https://apigateway.n2.example.com/api/v1/boxes/quick-boxes.
• companionUrl: نشانی سرویس بارگذاری تکه‌تکه‌ی همان گره. در موج اول مستند نشده است.
• name: نام کوتاه گره.

اگر کاربر هنوز گره‌ای نداشته باشد، همین درخواست یکی به او می‌سپارد. این سپردن دائمی است و پاسخ برای هر کاربر تغییر نمی‌کند، پس نتیجه را نگه دارید و برای هر درخواست دوباره نپرسید.

خطاها

کد	علت
401	توکن نیست، نامعتبر است یا ایمیل مسیر با ایمیل توکن یکی نیست.
503	هیچ گره‌ای ثبت نشده، یا مجوز استقرار هیچ گره‌ای را نام نبرده ("code": "NO_LICENSED_NODE"). موضوع را به مدیر سامانه بگویید.

استقرار تک‌سروری هم همین مسیر را دارد؛ فقط همیشه یک نشانی برمی‌گرداند.

جزئیات کامل در مرجع API، بخش «گره و نشانی API».