المنتجات

ضيف منتج

بيضيف منتج بنفس قواعد اللوحة (وحدود الباقة). ابعت multipart/form-data لو هترفع صور، أو JSON من غيرها وضيف الصور بعدين.

POSThttps://elmatajer.com/api/v1/vendor/products

الصلاحية: products.write

محتوى الطلب

الاسم	النوع	إلزامي	الوصف
`name`	string	نعم	اسم المنتج.
`price`	number	نعم	سعر البيع.
`category_ids`	integer[]	نعم	قسم واحد على الأقل (كل الأقسام).
`name_en, description, description_en`	string	لا	الاسم بالإنجليزي والوصف (HTML مسموح).
`compare_price`	number	لا	السعر قبل الخصم.
`sku`	string	لا	الكود بتاعك — بيتستخدم في المخزون بالـ SKU.
`manage_stock, stock_qty, low_qty`	bool / integer	لا	تتبّع المخزون وكميته.
`variants[]`	object[]	لا	`color` و`size` و`price` و`qty` و`sku` و`compare_price` لكل اختيار.
`images[]`	file[]	لا	لحد 10 صور (jpg أو png أو webp، 4 ميجا للصورة) — multipart بس.
`is_available`	bool	لا	ظاهر في المتجر (الافتراضي true).
`slug, meta_title, meta_description`	string	لا	حقول السيو.

الطلب

curl -X POST "https://elmatajer.com/api/v1/vendor/products" \
  -H "Api-Key: YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"name":"Cotton T-shirt","name_en":"Cotton T-shirt","price":299,"compare_price":349,"sku":"TS-001","category_ids":[74],"manage_stock":true,"stock_qty":40,"variants":[{"color":"Black","size":"L","price":299,"qty":10,"sku":"TS-001-BL-L"},{"color":"Black","size":"XL","price":299,"qty":8,"sku":"TS-001-BL-XL"}]}'

const res = await fetch("https://elmatajer.com/api/v1/vendor/products", {
  method: "POST",
  headers: {
    "Api-Key": process.env.ELMATAJER_API_KEY,
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
      "name": "Cotton T-shirt",
      "name_en": "Cotton T-shirt",
      "price": 299,
      "compare_price": 349,
      "sku": "TS-001",
      "category_ids": [
          74
      ],
      "manage_stock": true,
      "stock_qty": 40,
      "variants": [
          {
              "color": "Black",
              "size": "L",
              "price": 299,
              "qty": 10,
              "sku": "TS-001-BL-L"
          },
          {
              "color": "Black",
              "size": "XL",
              "price": 299,
              "qty": 8,
              "sku": "TS-001-BL-XL"
          }
      ]
  })
});
const data = await res.json();

$ch = curl_init("https://elmatajer.com/api/v1/vendor/products");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => "POST",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ["Api-Key: " . getenv('ELMATAJER_API_KEY'), "Accept: application/json", "Content-Type: application/json"],
    CURLOPT_POSTFIELDS     => json_encode([
        'name' => 'Cotton T-shirt',
        'name_en' => 'Cotton T-shirt',
        'price' => 299,
        'compare_price' => 349,
        'sku' => 'TS-001',
        'category_ids' => [
            74
        ],
        'manage_stock' => true,
        'stock_qty' => 40,
        'variants' => [
            [
                'color' => 'Black',
                'size' => 'L',
                'price' => 299,
                'qty' => 10,
                'sku' => 'TS-001-BL-L'
            ],
            [
                'color' => 'Black',
                'size' => 'XL',
                'price' => 299,
                'qty' => 8,
                'sku' => 'TS-001-BL-XL'
            ]
        ]
    ]),
]);
$data = json_decode(curl_exec($ch), true);

الرد `200`

{
    "status": "ok",
    "data": {
        "id": 22511,
        "name": "مجموعة مكعبات بناء",
        "name_en": "Building blocks set",
        "slug": "building-blocks-set",
        "sku": "BLK-01",
        "image": "https://cdn.elmatajer.com/…/blocks.webp",
        "images": [
            {
                "id": 81,
                "url": "https://cdn.elmatajer.com/…/blocks.webp"
            }
        ],
        "price": 120,
        "original_price": 132,
        "discount_pct": 9,
        "stock": {
            "state": "in",
            "qty": 31,
            "tracked": true,
            "low": 5
        },
        "category_ids": [
            74
        ],
        "is_available": true,
        "is_draft": false,
        "has_variants": false,
        "variants": [],
        "url": "https://your-store.elmatajer.com/detail-building-blocks-set",
        "created_at": "2026-10-01T10:00:00+03:00",
        "category": "ألعاب",
        "views": 214,
        "video_url": null,
        "description": "<p>…</p>"
    }
}

ضيف منتج

محتوى الطلب

الطلب

الرد 200

الرد `200`