---
title: "قائمة المنتجات (ترقيم بالمؤشر)"
method: GET
path: "/api/products"
---

# قائمة المنتجات (ترقيم بالمؤشر)

`GET /api/products`

## Request

- Base URL: `https://shop.alshhbaa.com`
- URL: `https://shop.alshhbaa.com/api/products`
- Auth: none required

يعرض المنتجات المنشورة بترقيم قائم على المؤشر (cursor-based): أرسل limit للتحكم بحجم الصفحة، ثم تابع nextCursor من كائن pagination حتى يصبح hasMore بقيمة false. المؤشر opaque ولا يجوز بناؤه يدوياً. حقلا price وsalePrice يعرضان السعر شاملاً الضريبة؛ priceIncludesVat يوضح ذلك.

## Query parameters

- `q` string
- `category` string
- `limit` string
- `cursor` string

## Response `200`

صفحة منتجات مع مؤشر المتابعة

- object
  - `products` object[], required
  - `total` integer: عدد عناصر الصفحة الحالية.
  - `pagination` object, required
    - `limit` integer, required
    - `nextCursor` string, nullable, required: مؤشر opaque للصفحة التالية. أرسله كـ cursor. null تعني نهاية القائمة.
    - `hasMore` boolean, required

## Other responses

- `400`: طلب غير صالح
- `429`: تجاوز حد الطلبات
- `500`: خطأ داخلي

---

[API](https://skmtc.dev/alshhbaa/apis/alshhbaa-copperware-api.md) · [All operations](https://skmtc.dev/alshhbaa/apis/alshhbaa-copperware-api/llms.txt) · [OpenAPI document](https://skmtc.dev/alshhbaa/apis/alshhbaa-copperware-api/revisions/eaa2e33e878f?raw)