سجل تغييرات المطورين

تنشئ هذه الصفحة خط الأساس الحالي لمنصة المطورين، ولا تختلق إصدارات تاريخية. يجب أن تحدد الإدخالات المستقبلية عقد API أو إصدار التطبيق المتأثر وأن تستخدم أحد التصنيفات التالية.

2026-09-30 — قراءة الفوترة وفوترة المتجر

• أضيفت GET /api/v1/billing: يقرأ أي تطبيق مثبت حالة فوترة تثبيته (payment_required وentitlement وsubscription) بأي رمز وصول صالح، دون نطاق إضافي، ولا يمكن الوصول إلى فوترة متجر آخر. ويسري حد الطلبات المعتاد لكل تثبيت.
• تتولى ساس فوترة خطط المتجر والاشتراكات والمشتريات لمرة واحدة والاسترجاع ومستحقات المطورين. راجع صفحة التسعير والفوترة.

2026-09-30 — صلاحيات الكتابة وتوسيع القراءة

• أضيفت تسع عشرة عملية: قراءة منتج وطلب وعميل واحد، والتصنيفات، وعناصر الطلب، وإنشاء المنتجات وتعديلها، وإنشاء الخصومات وتعديلها، وتعديل المخزون، ووسوم الطلبات والعملاء، وشحن الطلبات، وبيانات التطبيق الخاصة (app_data:manage).
• أصبحت catalog:write وdiscounts:write قابلة للطلب، وأضيفت orders:write_fulfillments وinventory:write وapp_data:manage. لم تعد orders:write_tags وcustomers:write_tags وcategories:read وorders:read_items محجوزة للمنصة. تبقى orders:write معطلة.
• تتطلب كل كتابة Idempotency-Key ويعاد التحقق منها داخل معاملة قاعدة البيانات نفسها، وتُتحقق السجلات المذكورة ضمن متجر التثبيت وتُدقق. يزيل التطبيق وسومه فقط ويعدل الخصومات التي أنشأها فقط.
• حدثان جديدان customers.updated وproducts.deleted، وتُحذف بيانات التطبيق الخاصة عند إلغاء التثبيت.

2026-09-09 — صلاحيات القراءة

• أربع صلاحيات جديدة وست نقاط لقراءة بيانات التواصل للعملاء والخصومات النشطة والمخزون وبيانات المتجر، بعقود مراجعة وموافقة التاجر.
• ترقيم دقيق بالوقت والمعرف وإعادة تحقق داخل معاملة القراءة. لا تشمل بيانات البنك أو الملاحظات الداخلية أو سجل استخدام الخصم.
• تبقى صلاحيات كتابة المنتجات والخصومات والطلبات معطلة.

إضافات وأمان — 2026-09-09

• نُفذت رحلة دخول التاجر ومراجعته واختياره الصريح للمتجر وتفويض S256 ذي الاستخدام الواحد، خلف بوابة الإصدار.
• تُفرض ثلاثة عقود صلاحيات تشغيلية وتُعطل طلبات الصلاحيات السبع غير المدعومة. التوسيع يتطلب مراجعة وموافقة جديدتين.
• يتحقق إرسال Webhook من مصدر التفويض الثابت ويستخدم سماحاً لمرة واحدة؛ لا يمكن استرجاع الطلبات التي سُمح بإرسالها بالفعل.
• نُفذت أحداث الموارد وإشعار الإلغاء المحدود مع عرض الأحداث للتاجر عند الموافقة. تبقى اختبارات البيئة الشاملة معلقة، ويظل تثبيت التطبيقات معطلاً.

التصنيفات

• مضاف Added: قدرة عامة جديدة متوافقة أو وثيقة جديدة.
• متغير Changed: توضيح متوافق أو تغير سلوك ضمن عقد حالي.
• مهمل Deprecated: قدرة حالية لها بديل وحوكمة منشوران.
• محذوف Removed: قدرة أزيلت وفق حوكمة منشورة.
• أمني Security: تصحيح أمني عام أو إجراء مطلوب من المطور، من دون تفاصيل استغلال داخلية.

أمني — 2026-08-24

• تأتي بيانات العرض العامة للسوق الآن من لقطات مراجعة غير قابلة للتعديل ومرتبطة بالإصدار، ويجري النشر بتسلسل حول مؤشر العرض النشط المحمي.
• يفشل مصدر بيانات العرض القديمة الذي لا يمكن إثباته بشكل مغلق. ويجب رفض الإصدار القديم المرسل قبل أن يقدم المطور المالك مسودة بديلة مكتملة ويعود إلى دورة المراجعة المعتادة.
• متابعة تاريخية: دُمج لاحقاً ربط التفويض بالإصدار المراجع والجيل في PR #188. يصف المرجع الحالي السلوك المنفذ.
• تبقى التثبيتات القائمة مرتبطة بإصدارات التطبيقات المثبتة والصلاحيات الممنوحة. يوضح الإدخال الأحدث عمل الموافقة والصلاحيات والإرسال اللاحق؛ السوق ما زالت معطلة قبل التفعيل.

خط الأساس — 2026-08-23

مضاف

• مصادر عربية وإنجليزية مترابطة للويكي مع slug مشترك ثابت وملكية وحالة وتاريخ تحقق وتسلسل وإصدارات API المنطبقة.
• مرجعان عامان لحد الامتداد ونموذج التفويض.
• مرجع قانوني لعمليات API v1 الخمس والنطاقات العشرة المسجلة.
• قواعد تطوير السوق والسلوك المحظور والحالات ونموذج الاختبار وتدفق المراجعة.

متغير

• توثيق OAuth بالحالة PARTIAL لأن بدء موافقة التاجر غير مكتمل.
• توثيق تغطية نطاقي المنتجات والطلبات بصورة ضيقة وصادقة.
• فصل تصريحات Webhook عن أحداث الأعمال المتحقق من انبعاثها.
• توثيق إعادة إنشاء Webhook لسر توقيع يستخدم مرة واحدة.
• مطابقة الأخطاء وحد المعدل الثابت لكل تثبيت ومسار مع سلوك التشغيل الحالي.

مهمل

• لا شيء. حوكمة الإهمال الرسمية مخططة.

محذوف

• لم تحذف قدرة تشغيل عامة. حذفت ادعاءات توثيق غير مدعومة من العقد.

أمني

• تحظر القواعد العامة الآن الاعتماد على الطوبولوجيا الداخلية والوصول إلى قاعدة خاصة واستخدام service role وتسجيل الاعتماد والوصول بين المستأجرين وتجاوز التفويض.