قائمة المنتجات

GET https://app.alaaqat.com/api/products

تعرض هذه النقطة المنتجات في حسابك، الأحدث أولاً. يحتاج مفتاح واجهة التطبيق البرمجية إلى الإمكانية product-index.

تضم القائمة المنتجات التي يراها في التطبيق عضو الفريق الذي أنشأ المفتاح: جميعها مع صلاحية عرض المنتجات، أو تلك التي يملكها هو أو فرقه فقط مع صلاحية عرض المنتجات الخاصة بالفريق أو عرض المنتجات الخاصة بالمستخدم.

ترويسة الطلب

{
    "Accept": "application/json"
}

المعطيات

تقبل هذه النقطة معطيات الصفحات بحد أقصى 250 سجلاً في الصفحة، وتدعم التصفية المعقدة.

المفتاح النوع الافتراضي الوصف
search نص - البحث حسب الاسم.
complex_filters مصفوفة [] التصفية حسب قيم الخصائص. راجع التصفية المعقدة.
forAssociationType نص - مع forAssociationId، تعرض فقط المنتجات المرتبطة بسجل واحد. راجع الارتباطات.
forAssociationId نص - قيمة _id للسجل الذي تريد المنتجات المرتبطة به.

الإستجابة

200 OK، أو 206 Partial Content إذا تبقّت صفحات أخرى. تأتي المنتجات ضمن data، وقيم خصائص كل سجل ضمن properties. راجع الصفحات لمعنى links وmeta.

{
    "data": [
        {
            "properties": {
                "_id": "6656b1c2d3e4f5a6b7c8d901",
                "name": "Ergonomic office chair",
                "sku": "CH-ERGO-01",
                "price": 120,
                "cost": 74.5,
                "status": "available",
                "description": "Adjustable height and lumbar support, black mesh back.",
                "owner": 12,
                "created_by": 12,
                "updated_at": "2026-10-20T09:30:00.000000Z",
                "created_at": "2026-10-20T09:30:00.000000Z"
            },
            "account_id": 1024
        },
        {
            "properties": {
                "_id": "6656b1c2d3e4f5a6b7c8d902",
                "name": "Standing desk",
                "sku": "DK-STAND-02",
                "price": 340,
                "cost": 210,
                "status": "available",
                "description": "Electric height adjustment, oak top.",
                "owner": 12,
                "created_by": 12,
                "updated_at": "2026-10-18T11:00:00.000000Z",
                "created_at": "2026-10-18T11:00:00.000000Z"
            },
            "account_id": 1024
        }
    ],
    "links": {
        "first": "https://app.alaaqat.com/api/products?page=1",
        "last": "https://app.alaaqat.com/api/products?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "« Previous",
                "active": false
            },
            {
                "url": "https://app.alaaqat.com/api/products?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next »",
                "active": false
            }
        ],
        "path": "https://app.alaaqat.com/api/products",
        "per_page": 15,
        "to": 2,
        "total": 2
    }
}