النطاقات
مرجع صلاحيات التطبيقات
كل النطاقات المسجلة ومخاطرها وتغطيتها العامة الفعلية وإمكانية طلبها والصلاحيات المحجوزة للمنصة وعقودها المراجعة.
النطاقات صلاحيات للتطبيق وليست أدواراً بشرية. يطلبها إصدار التطبيق ويمنح مالك المتجر أو مديره مجموعة فرعية منها عند التثبيت. وتتحقق الواجهة في كل طلب من التثبيت النشط والمستأجر والإصدار المحدد والرمز والنطاق المطلوب للمسار.
أقل صلاحية والمعنى المرئي للتاجر
اطلب فقط نطاقاً يقابل عملية موثقة يستخدمها تطبيقك. وضح للتاجر سبب الحاجة إلى كل منحة والبيانات أو الإجراء الذي تغطيه. يستدعي تصنيف الخطر العالي مراجعة أقوى، لكنه لا يجعل القدرة تشغيلية.
حقيقة السجل الحالي
| النطاق | الخطر | الحالة | التغطية العامة الفعلية والمحاذير |
|---|---|---|---|
app_data:manage | منخفض | CURRENT | GET /api/v1/app-data وGET/PUT/DELETE /api/v1/app-data/{key}؛ بيانات خاصة بهذا التثبيت (16 كيلوبايت للقيمة و10,000 مفتاح) وتُحذف عند إلغاء التثبيت. |
catalog:read | منخفض | CURRENT | GET /api/v1/catalog/products وGET /api/v1/catalog/products/{id} مع الخيارات والمتغيرات؛ التصنيفات تحتاج categories:read. |
catalog:write | عالٍ | CURRENT | POST /api/v1/catalog/products وPATCH /api/v1/catalog/products/{id}؛ الحقول الأساسية فقط دون الوسائط أو المتغيرات أو المخزون أو إعدادات الدفع. |
categories:read | منخفض | CURRENT | GET /api/v1/catalog/categories؛ التصنيفات النشطة فقط. |
customers:read | عالٍ | CURRENT | GET /api/v1/customers وGET /api/v1/customers/{id}؛ الاسم والهاتف والبريد وتاريخ الإنشاء فقط. |
customers:write_tags | عالٍ | CURRENT | POST /api/v1/customers/{id}/tags وDELETE /api/v1/customers/{id}/tags/{tag}؛ يزيل التطبيق ما أضافه هو فقط. |
discounts:read | متوسط | CURRENT | GET /api/v1/discounts؛ قواعد ورموز الخصومات النشطة حاليًا دون سجل استخدام العملاء. |
discounts:write | عالٍ | CURRENT | POST /api/v1/discounts وPATCH /api/v1/discounts/{id}؛ يعدل التطبيق الأكواد التي أنشأها فقط ولا يحذفها. |
inventory:read | متوسط | CURRENT | GET /api/v1/inventory/locations و/levels و/movements؛ الكميات والمعرفات دون الملاحظات أو هوية الموظف. |
inventory:write | عالٍ | CURRENT | POST /api/v1/inventory/adjustments؛ حركة مخزون واحدة لكل تعديل في موقع نشط، ولا تنخفض الكمية عن المحجوز. |
media:read_products | منخفض | PARTIAL | عقد مراجع قابل للطلب بلا عملية عامة بعد؛ مراجع صور المنتجات متاحة عبر catalog:read. |
orders:read | عالٍ | CURRENT | GET /api/v1/orders وGET /api/v1/orders/{id}؛ ملخصات الطلبات فقط. |
orders:read_items | عالٍ | CURRENT | GET /api/v1/orders/{id}/items؛ معرفات المنتج والمتغير والاسم وقت الشراء والكمية والأسعار دون بيانات العميل. |
orders:write | عالٍ | PLANNED | مسجل لكنه معطل وغير قابل للطلب؛ لا يوجد تعديل عام شامل للطلبات. |
orders:write_fulfillments | عالٍ | CURRENT | POST /api/v1/orders/{id}/fulfillments؛ شركة الشحن ورقم التتبع، والطلب المؤكد أو قيد التجهيز يصبح تم الشحن. |
orders:write_tags | متوسط | CURRENT | POST /api/v1/orders/{id}/tags وDELETE /api/v1/orders/{id}/tags/{tag}؛ يزيل التطبيق وسومه فقط. |
store:read | منخفض | CURRENT | GET /api/v1/store؛ الاسم والمعرف والنطاق الفرعي دون الإعدادات الخاصة أو بيانات البنك. |
webhooks:manage | متوسط | CURRENT | إدارة الاشتراكات واستلام أحداث الموارد المراجعة فقط بعقد webhooks.events.v2؛ اجتاز التسليم اختبار المختبر الخاص. |
طلب الصلاحيات وموافقة التاجر
كل نطاق بحالة CURRENT أعلاه، إضافة إلى media:read_products، قابل للطلب من إصدارات تطبيقات المطورين. يبقى orders:write معطلًا. يرتبط كل إصدار خاضع للمراجعة بمعرّف العقد التشغيلي لصلاحياته (مثل catalog.products.write.v1)، وتحتفظ صلاحيات الوسوم بمعرّفيها الحاليين official.order_tags.write.v1 وofficial.customer_tags.write.v1. أي توسعة مستقبلية تتطلب إصدارًا جديدًا مراجعًا وموافقة جديدة من التاجر؛ ولا يحصل رمز الدخول القديم على الصلاحية الموسعة تلقائيًا. هذه الصلاحيات لا تسمح باستدعاء قاعدة البيانات الخاصة أو نقاط نهاية غير موثقة.
الصلاحيات المحجوزة للمنصة
الصلاحيات segments:write_membership وnotifications:write وthemes:write_extensions وforms:manage_submissions وassets:manage_digital خاصة بالتطبيقات الرسمية، وnative:invoke خاصة بالموصلات الأصلية المراجعة. يُرفض طلبها من إصدار تطبيق خارجي بالرمز scope_platform_only (أو native_scope_platform_only)، ولا تمنح أي عملية API عامة.
التعامل بالإغلاق الآمن
اعتبر 401 رمزاً مفقوداً أو غير صالح و403 رفضاً للعملية حيث يوثق ذلك. لا تعد المحاولة برفع النطاقات أو تغيير معرف المستأجر أو رش الرموز أو استخدام اعتماد داخلي بديل. اطلب من التاجر الموافقة على إصدار خاضع للمراجعة عند الحاجة المشروعة إلى منحة جديدة.