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

جست‌وجو و فهرست حساب‌های مشترک

GET 

/api/v1/services

حساب‌های مشترک را صفحه‌به‌صفحه فهرست می‌کند، به ترتیب جدیدترین تغییر، و می‌تواند آن‌ها را بر اساس ایمیل یا نام جست‌وجو کند. صفحه‌ی «مشترکان» در برنامه‌ی وب از همین مسیر استفاده می‌کند.

دسترسی: برای ناظر و مدیر سامانه است. ناظر (و مدیر سامانه) همه‌ی حساب‌ها به‌جز حساب خودش را می‌بیند؛ کاربر عادی با حق READ فقط حساب خودش را. مدیر سامانه می‌تواند این مسیر را روی گره‌ای هم فراخوانی کند که در آن حساب مشترک ندارد. به x-container نیاز ندارد.

پاسخ: total (تعداد کل نتیجه‌ها)، page، pageSize و items (حساب‌ها). حساب‌های حذف‌شده در نتیجه نمی‌آیند.

خطاها: 400 اگر q بیشتر از ۲۵۶ نویسه باشد.

نکته: page از ۱ شروع می‌شود و هر مقدار نامعتبر یعنی صفحه‌ی اول. pageSize به‌طور پیش‌فرض ۵۰ و حداکثر ۲۰۰ است. جست‌وجو به بزرگی و کوچکی حروف حساس نیست و نویسه‌های % و _ به‌صورت عادی جست‌وجو می‌شوند.

درخواست​

پاسخ‌ها​