النقاط الأساسية لتصميم عقود بيانات JSON API
ستة أمور يصعب جداً تغييرها بعد النشر: أغلفة الاستجابة، صيغ الأخطاء، شكل الترقيم، تمثيل المعرفات والوقت، دلالات null مقابل الغياب، وتطور الإصدار.
متوسطقراءة نحو 13 دقيقةحُدِّث في 2026-10-30
الممارسة الهندسية
وضع JSON في أنظمة حقيقية: كيف تعرّف عقود API، وكيف تدير الإعدادات وfixtures، وكيف تتعامل مع توافق الإصدارات، وكيف تحافظ على بيانات الاختبار.
5 مقالةمقالات هذه الفئة
إدارة JSON للإعدادات وfixtures والبيانات المحلية
يجب أن تكون الإعدادات متعددة الطبقات ومتحققة؛ ويجب أن تكون fixtures حتمية وقابلة للقراءة والـdiff. إذا أُدير هذان النوعان من الملفات بشكل سيئ، تبقى تكاليف التشخيص مرتفعة لوقت طويل.
مبتدئقراءة نحو 10 دقيقةحُدِّث في 2026-10-30
عندما تختلف وثيقتا JSON: diff حسب الموضع، أو diff حسب id، أو التطبيع أولاً
خمسون سجلاً تصبح واحداً وخمسين فيبلّغ الـdiff عن خمسين تغييراً. يغطي الإيجابيات الكاذبة في diff النصوص، ومطابقة المصفوفات بـid، وتطبيع jq والـpatches القابلة للتطبيق.
مبتدئقراءة نحو 6 دقيقةحُدِّث في 2026-10-30
تعارضات دمج Git في ملفات JSON: لماذا يكتب merge=union JSON معطوباً
merge=union يسمح بمرور JSON معطوب ويظل يبلّغ عن النجاح. يشرح هذا دليل دمج ثلاثي واعٍ بالمفاتيح لـJSON، إضافة إلى ثلاث عادات تقلّل التعارضات.
متوسطقراءة نحو 7 دقيقةحُدِّث في 2026-10-30
إصدارات عقود JSON: التوافق، الإهلاك، وترحيل البيانات
إضافة حقل ليست آمنة تلقائياً. يغطي حدود التوافق، وحقول الإصدار، ونوافذ الإهلاك، وترحيل dual-write، واختبارات العقود، ومقاييس الكناري.
متقدمقراءة نحو 10 دقيقةحُدِّث في 2026-10-31