عرض منتج

GET https://app.alaaqat.com/api/products/{product_id}

حيث product_id هو قيمة _id للمنتج. تُرجع هذه النقطة سجلاً واحداً. يحتاج مفتاح واجهة التطبيق البرمجية إلى الإمكانية product-show.

ترويسة الطلب

{
    "Accept": "application/json"
}

الإستجابة

200 OK، ويأتي السجل ضمن data وقيم خصائصه ضمن data.properties. لا تظهر في الاستجابة الخاصية التي لا قيمة لها.

تأتي معرّفات السجلات المرتبطة بالمنتج ضمن contact_ids وdeal_ids وما يشبهها، وعددها ضمن contacts_count وdeals_count وما يشبهها. راجع الارتباطات.

{
    "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",
            "contact_ids": [
                "6650f1a2b3c4d5e6f7a8b901"
            ],
            "contacts_count": 1
        },
        "account_id": 1024
    }
}

الأخطاء

الرمز المعنى
403 السجل موجود، لكن عضو الفريق الذي أنشأ المفتاح لا يرى إلا المنتجات التي يملكها هو أو فرقه، وهذا السجل ليس منها.
404 لا يوجد في حسابك سجل بقيمة _id هذه.