GET /search?q=...

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

عنوان، متن، tag، خلاصه و metadata امن آیتم‌های قابل مشاهده را جست‌وجو می‌کند.

احراز هویت

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

پارامترها

نام	محل	نوع	الزامی	توضیح
q	query	string	بله	عبارت جست‌وجو؛ حداکثر ۲۰۰ کاراکتر.
category	query	string	خیر	یکی از دسته‌های معتبر catalog.
kind	query	string	خیر	نوع رکورد، مانند document یا media.
type	query	string	خیر	نوع دانش؛ برای media معمولاً screenshot.
visibility	query	string	خیر	PUBLIC، INTERNAL، MANAGEMENT یا RESTRICTED؛ private filter مجوز می‌خواهد.
language	query	string	خیر	کد زبان مانند fa یا en.
tag	query	string	خیر	برچسب کوچک حروف‌کوچک و خط تیره.
status	query	string	خیر	وضعیت رکورد؛ media به‌طور پیش‌فرض current است.
updated_after	query	ISO date	خیر	رکوردهای به‌روزشده بعد از این زمان.
pageId	query	string	خیر	شناسهٔ معنایی صفحه در media.
viewport	query	desktop \| mobile	خیر	نوع viewport تصویر.
capturedAfter	query	ISO date	خیر	media ثبت‌شده بعد از این زمان.
limit	query	integer	خیر	پیش‌فرض ۲۰ و حداکثر ۱۰۰.
cursor	query	string	خیر	offset opaque برای صفحهٔ بعد؛ nextCursor را دوباره ارسال کنید.

نمونهٔ درخواست

cURL

curl "https://luma-knowledge.pages.dev/api/v1/search?q=workflow&limit=10"

نمونهٔ پاسخ

JSON

{
  "data": [{
    "id": "workflow",
    "kind": "document",
    "title": "راهنمای Workflow لوما",
    "snippet": "...",
    "score": 2,
    "apiUrl": "/api/v1/documents/workflow"
  }],
  "pagination": {"limit": 20, "cursor": "0", "nextCursor": null, "total": 1}
}

خطاهای مرتبط

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

Try it

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

جست‌وجو در دانش لوما

دانش لوما

جست‌وجوی دانش