GET /people

این endpoint چه می‌کند؟

افراد قابل مشاهده را بدون اطلاعات تماس خصوصی فهرست می‌کند.

عمومی یا مجاز بر اساس visibility. API رکوردهای خارج از scope را در پاسخ، search و direct ID نمایش نمی‌دهد.

نام	محل	نوع	الزامی	توضیح
visibility	query	string	خیر	PUBLIC، INTERNAL، MANAGEMENT یا RESTRICTED؛ private filter مجوز می‌خواهد.
status	query	string	خیر	وضعیت رکورد؛ media به‌طور پیش‌فرض current است.
limit	query	integer	خیر	پیش‌فرض ۲۰ و حداکثر ۱۰۰.
cursor	query	string	خیر	offset opaque برای صفحهٔ بعد؛ nextCursor را دوباره ارسال کنید.

cURL

curl "https://luma-knowledge.pages.dev/api/v1/people"

JSON

{
  "data": [],
  "pagination": {"limit": 20, "cursor": "0", "nextCursor": null, "total": 0}
}

400 invalid_query برای query نامعتبر و 404 not_found برای resource غیرقابل مشاهدهٔ احتمالی برگردانده می‌شود. شکل خطا در راهنمای خطا آمده است.

فقط درخواست GET عمومی؛ credential در مرورگر استفاده نمی‌شود.