GET /media

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

تصاویر فعلی را فهرست می‌کند و pageId، viewport، status و زمان ثبت را فیلتر می‌کند.

احراز هویت

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

پارامترها

نام	محل	نوع	الزامی	توضیح
type	query	string	خیر	نوع دانش؛ برای media معمولاً screenshot.
pageId	query	string	خیر	شناسهٔ معنایی صفحه در media.
viewport	query	desktop \| mobile	خیر	نوع viewport تصویر.
status	query	string	خیر	وضعیت رکورد؛ media به‌طور پیش‌فرض current است.
capturedAfter	query	ISO date	خیر	media ثبت‌شده بعد از این زمان.
tag	query	string	خیر	برچسب کوچک حروف‌کوچک و خط تیره.
limit	query	integer	خیر	پیش‌فرض ۲۰ و حداکثر ۱۰۰.
cursor	query	string	خیر	offset opaque برای صفحهٔ بعد؛ nextCursor را دوباره ارسال کنید.

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

cURL

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

نمونهٔ پاسخ

JSON

{
  "data": [{
    "id": "public-home-desktop-viewport-v0002",
    "kind": "media",
    "type": "screenshot",
    "status": "current",
    "viewport": {"name": "desktop", "width": 1440, "height": 900}
  }],
  "pagination": {"limit": 20, "cursor": "0", "nextCursor": null, "total": 1}
}

خطاهای مرتبط

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

Try it

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

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

دانش لوما

فهرست تصاویر و media