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

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

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 وتسجيل الاعتماد والوصول بين المستأجرين وتجاوز التفويض.