عن المشروع

JSON Server هي حزمة Node.js تقوم بإنشاء REST API وهمية من ملف بيانات JSON أو JSON5. بعد التثبيت باستخدام npm install json-server، تقوم بإنشاء ملف db.json أو db.json5 يحتوي على موارد مثل posts وcomments وprofile، ثم تشغل npx json-server db.json. يبدأ الخادم افتراضياً عند http://localhost:3000 ويوفر نقاط نهاية REST لموارد المصفوفات وموارد الكائنات الفردية. تدعم موارد المصفوفات عمليات GET للمجموعة والعنصر، وPOST، وPUT، وPATCH، وDELETE. بينما تدعم موارد الكائنات عمليات GET وPUT وPATCH. تشمل قدرات الاستعلام شروط الحقول باستخدام المعاملات eq وne وlt وlte وgt وgte وin وcontains وstartsWith وendsWith؛ والفرز باستخدام _sort والحقول التنازلية المسبوقة بـ -؛ والتقسيم باستخدام _page و_per_page، مع إرجاع بيانات وصفية مثل first وprev وnext وlast وpages وitems وdata؛ وتضمين العلاقات باستخدام _embed؛ والتصفية المعقدة باستخدام _where عبر كائن JSON. يمكن حذف التابعين باستخدام _dependent. يتم تقديم الملفات الثابتة من ./public تلقائياً، ويمكن إضافة أدلة ثابتة إضافية باستخدام -s. تشير ملاحظات README إلى تغييرات الانتقال من v0 إلى v1: المعرفات (ids) تكون دائماً سلاسل نصية ويتم إنشاؤها تلقائياً إذا كانت مفقودة؛ يستخدم التقسيم _per_page بدلاً من _limit؛ تستخدم العلاقات _embed بدلاً من _expand؛ وتمت إزالة خيار CLI المسمى --delay لصالح ميزة throttling في أدوات تطوير المتصفح. يذكر README أن v1 في مرحلة beta وقد تحتوي على تغييرات جذرية، مع توفر التوثيق المستقر في الإصدار v0.17.4.