العربية

الصلاحيات والخطط

يتطلب الوصول خطة متجر مؤهلة وصلاحيات فعالة للمفتاح معًا.

قبل استدعاء واجهة API

المصادقة
تحقق من المصادقة.
متاح بدءًا من
تحقق من أن خطة المتجر تتضمن وظيفة API المطلوبة.
الصلاحيات المطلوبة
تحقق من صلاحيات المفتاح وشروط الحقول التي ترسلها.

ما الخطة المطلوبة

ما الخطة المطلوبة
متاح بدءًا من	الوصف
BASIC	تشمل BASIC قراءة طلبات الشراء وطلبات خدمة العملاء، وتغيير حالاتها وحالة دفع طلب الشراء والمبلغ المسترد المسجل.
STANDARD	تتطلب عمليات الكتالوج وCMS والبحث والمخزون خطة STANDARD أو أعلى.

تحصل المتاجر ذات الاشتراكات القائمة على وظائف API المشمولة في خطتها.

حدود معدل الطلبات

صلاحيات العملية المحددة

يسرد المرجع required_scopes لكل عملية وconditional_scopes للحقول أو التغييرات الحساسة.
قراءة مورد لا تمنح صلاحية إنشائه أو تعديله أو حذفه.
يظل إصدار الرموز وقراءة السياق يتطلبان المصادقة حتى عندما لا تُذكر صلاحية مورد.

عرض القائمة

GET/api/v1/products

المصادقة: Bearer
متاح بدءًا من: STANDARD
الصلاحيات المطلوبة: catalog.product:read

تحديث

PATCH/api/v1/products/{product_id}

المصادقة: Bearer
متاح بدءًا من: STANDARD
الصلاحيات المطلوبة: catalog.product:update

متى تلزم صلاحيات إضافية

تحديث

PATCH/api/v1/products/{product_id}

المصادقة: Bearer
متاح بدءًا من: STANDARD
الصلاحيات المطلوبة: catalog.product:update
صلاحيات إضافية لحقول محددة: عند تضمين variant_value_ids: catalog.product_variant:create, catalog.product_variant:update, catalog.product_variant:delete
عند تضمين variants_enabled: catalog.product_variant:update

ما الذي يحدث عند تغيير الخطة

عندما يؤدي تخفيض الخطة إلى إزالة صلاحية، تُحذف من مفاتيح API ويُلغى تحديدها وتصبح معطلة في لوحة الإدارة.

المصادقة

الأخطاء والتعافي