GET /categories/:category/items

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

آیتم‌های یک دستهٔ معتبر را با pagination برمی‌گرداند.

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

نام	محل	نوع	الزامی	توضیح
category	مسیر	string	بله	یکی از دسته‌های معتبر catalog.
limit	query	integer	خیر	پیش‌فرض ۲۰ و حداکثر ۱۰۰.
cursor	query	string	خیر	offset opaque برای صفحهٔ بعد؛ nextCursor را دوباره ارسال کنید.

cURL

curl "https://luma-knowledge.pages.dev/api/v1/categories/product/items"

JSON

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

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

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