سجل التغييرات وسياسة الإصدارات

سياسة الإصدارات

الإصدار في المسار: /v1.

داخل v1 نضيف فقط:

• نقاط نهاية جديدة.
• حقول اختيارية جديدة في الطلبات.
• حقول جديدة في الردود.
• أنواع أحداث جديدة.
• قيم جديدة في القوائم الثابتة، مثل حالة طلب أو سبب إلغاء.
• رموز أخطاء جديدة.

لذلك تجاهل أي حقل أو قيمة أو نوع لا تعرفه، ولا تفشل بسببه.

داخل v1 لا نفعل أبدا:

• حذف حقل أو تغيير اسمه.
• تغيير نوع حقل أو معناه.
• جعل حقل اختياري مطلوبا.
• تغيير طريقة التوقيع.

التغيير الذي يكسر شيفرتك يأتي في /v2. يتوقف v1 بعد 12 شهرا من إعلان v2. من يوم الإعلان، كل نقطة نهاية ستتوقف ترد بترويستي Deprecation وSunset، وفي Sunset تاريخ التوقف.

التغييرات

v1.0 قريبا

الإصدار الأول:

• المفاتيح والتوقيع وبيئة التجربة.
• الربط برمز أو QR.
• الأماكن وإيقاف الطلبات مؤقتا.
• القوائم بصيغة CM v1: نشر كامل، تعديل بالفروقات، حالة، نسخ وبصمات، ومطابقة ليلية.
• الطلبات للاستلام من الفرع.
• الأحداث مجمعة وموقعة، وسجل الأحداث.

قادم بعده: التسعير من نظامك، المنتجات للمتاجر، المخزون، العروض، المحاسبة، التوصيل.