المنتجات
اقرأ منتجات الكتالوج وأنشئها وحدّثها واحذفها في السياق المحدد.
العمليات
عرض القائمة — المنتجاتاقرأ بيانات «المنتجات». تعتمد النتيجة على معلمات هذه العملية.
GET
جلب — المنتجاتعرض قوائم المنتجات وتفاصيل المنتج.
GET
إنشاء — المنتجاتإضافة منتجات جديدة إلى الكتالوج.
POST
تحديث — المنتجاتتغيير المنتجات الحالية والأسعار وبيانات النشر.
PATCH
حذف — المنتجاتإزالة المنتجات من لوحة الإدارة وواجهة المتجر والبحث مع الاحتفاظ ببيانات المعاملات السابقة.
DELETE
المنتجات · إضافة ملفات · upload_idبعد إنشاء upload_id أرسل الملفات بصيغة multipart/form-data ثم اربطها بالمنتج. يتطلب التنزيل رمز Bearer وصلاحية category؛ يحتوي الرد على بايتات الملف دون عنوان عام أو كلمة مرور. قاعدة وصول صريحة إلى الملف المشترك. new_purchases / recent_and_new / selected / all_purchasers.
POST
المنتجات · الحالة · upload_idبعد إنشاء upload_id أرسل الملفات بصيغة multipart/form-data ثم اربطها بالمنتج. يتطلب التنزيل رمز Bearer وصلاحية category؛ يحتوي الرد على بايتات الملف دون عنوان عام أو كلمة مرور. قاعدة وصول صريحة إلى الملف المشترك. new_purchases / recent_and_new / selected / all_purchasers.
GET
المنتجات · إضافة ملفات · multipartبعد إنشاء upload_id أرسل الملفات بصيغة multipart/form-data ثم اربطها بالمنتج. يتطلب التنزيل رمز Bearer وصلاحية category؛ يحتوي الرد على بايتات الملف دون عنوان عام أو كلمة مرور. قاعدة وصول صريحة إلى الملف المشترك. new_purchases / recent_and_new / selected / all_purchasers.
PUT
المنتجات · ملفات المنتجبعد إنشاء upload_id أرسل الملفات بصيغة multipart/form-data ثم اربطها بالمنتج. يتطلب التنزيل رمز Bearer وصلاحية category؛ يحتوي الرد على بايتات الملف دون عنوان عام أو كلمة مرور. قاعدة وصول صريحة إلى الملف المشترك. new_purchases / recent_and_new / selected / all_purchasers.
GET
المنتجات · إضافة ملفات · product_idبعد إنشاء upload_id أرسل الملفات بصيغة multipart/form-data ثم اربطها بالمنتج. يتطلب التنزيل رمز Bearer وصلاحية category؛ يحتوي الرد على بايتات الملف دون عنوان عام أو كلمة مرور. قاعدة وصول صريحة إلى الملف المشترك. new_purchases / recent_and_new / selected / all_purchasers.
POST
المنتجات · تنزيل · الملفبعد إنشاء upload_id أرسل الملفات بصيغة multipart/form-data ثم اربطها بالمنتج. يتطلب التنزيل رمز Bearer وصلاحية category؛ يحتوي الرد على بايتات الملف دون عنوان عام أو كلمة مرور. قاعدة وصول صريحة إلى الملف المشترك. new_purchases / recent_and_new / selected / all_purchasers.
GET
المنتجات · الترويساتبعد إنشاء upload_id أرسل الملفات بصيغة multipart/form-data ثم اربطها بالمنتج. يتطلب التنزيل رمز Bearer وصلاحية category؛ يحتوي الرد على بايتات الملف دون عنوان عام أو كلمة مرور. قاعدة وصول صريحة إلى الملف المشترك. new_purchases / recent_and_new / selected / all_purchasers.
HEAD
المنتجات · إضافة ملفات · النسخةبعد إنشاء upload_id أرسل الملفات بصيغة multipart/form-data ثم اربطها بالمنتج. يتطلب التنزيل رمز Bearer وصلاحية category؛ يحتوي الرد على بايتات الملف دون عنوان عام أو كلمة مرور. قاعدة وصول صريحة إلى الملف المشترك. new_purchases / recent_and_new / selected / all_purchasers.
POST
المنتجات · إزالة · الملفبعد إنشاء upload_id أرسل الملفات بصيغة multipart/form-data ثم اربطها بالمنتج. يتطلب التنزيل رمز Bearer وصلاحية category؛ يحتوي الرد على بايتات الملف دون عنوان عام أو كلمة مرور. قاعدة وصول صريحة إلى الملف المشترك. new_purchases / recent_and_new / selected / all_purchasers.
DELETE
المنتجات · الإصدارات الرقميةبعد إنشاء upload_id أرسل الملفات بصيغة multipart/form-data ثم اربطها بالمنتج. يتطلب التنزيل رمز Bearer وصلاحية category؛ يحتوي الرد على بايتات الملف دون عنوان عام أو كلمة مرور. قاعدة وصول صريحة إلى الملف المشترك. new_purchases / recent_and_new / selected / all_purchasers.
GET
المنتجات · إضافة ملفات · مسودةأُوقفت هذه العملية وتعيد 409 دون تغيير البيانات. اضبط الوصول لكل ملف رقمي على حدة من خلال اختيار المستلمين.
POST
المنتجات · الطلب · مسودةأُوقفت هذه العملية وتعيد 409 دون تغيير البيانات. اضبط الوصول لكل ملف رقمي على حدة من خلال اختيار المستلمين.
PATCH
المنتجات · إزالة · مسودةأُوقفت هذه العملية وتعيد 409 دون تغيير البيانات. اضبط الوصول لكل ملف رقمي على حدة من خلال اختيار المستلمين.
DELETE
المنتجات · نشر الإصدارأُوقفت هذه العملية وتعيد 409 دون تغيير البيانات. اضبط الوصول لكل ملف رقمي على حدة من خلال اختيار المستلمين.
POST
المنتجات · سحب العرضأُوقفت هذه العملية وتعيد 409 دون تغيير البيانات. اضبط الوصول لكل ملف رقمي على حدة من خلال اختيار المستلمين.
POST
المنتجات · الوصول إلى الملفات المستقبلية بعد الشراءأُوقفت هذه العملية وتعيد 409 دون تغيير البيانات. اضبط الوصول لكل ملف رقمي على حدة من خلال اختيار المستلمين.
PATCH
قراءة مستلمي الملفاقرأ قاعدة الوصول وإصدار المنتج. يظل وقت النشر الأول هو المرجع الزمني.
GET
اختيار مستلمي الملفاختر المشتريات المؤهلة. يجب أن تتضمن الطلبات المحددة هذا المنتج مدفوعًا ودون رد مبلغه.
PATCH
آلية العمل
يستطيع التكامل قراءة المنتجات غير المحذوفة، بما فيها المسودات، باستثناء المنتجات المحظورة بسبب حد في الخطة. تُستبعد المنتجات المحظورة من القوائم؛ ويعيد الوصول المباشر entitlements.resource_blocked. لذلك يختلف ظهور المنتج في API عن نشره في واجهة المتجر.
استخدم معرّفات موجودة للعلامات التجارية والفئات والخصائص والوسائط. تتضمن الأسعار عملة وقائمة أسعار ومعاملة ضريبية وإصدارات تزامن صريحة. أسعار المنتجات والمتغيرات مستقلة؛ استخدم بنية التسعير المدعومة والسلاسل العشرية الدقيقة.
ملفات المنتج
بعد إنشاء upload_id أرسل الملفات بصيغة multipart/form-data ثم اربطها بالمنتج. يتطلب التنزيل رمز Bearer وصلاحية category؛ يحتوي الرد على بايتات الملف دون عنوان عام أو كلمة مرور. قاعدة وصول صريحة إلى الملف المشترك. new_purchases / recent_and_new / selected / all_purchasers.
اختر ملف PDF أو ZIP أو EPUB أو MP3 أو MP4, WebP, PNG, JPG, SVG, AVIF صالحًا. حتى 250 MiB لكل ملف. يمكن أن يحتوي المنتج على 20 ملفًا نشطًا كحد أقصى.