كيفية استخدام مخطط JSON للتحقق من صحة بياناتك

ما هو مخطط JSON؟

مخطط JSON هو طريقة معيارية لوصف هيكل بيانات JSON الخاصة بك، الحقول المطلوبة وأنواع القيم. فكر فيه كعقد أو مخطط هندسي لما يجب أن يبدو عليه JSON صالحًا. يُكتب مخطط JSON بصيغة JSON نفسها، مما يجعله قابلًا للقراءة آليًا وسهل التعديل.

لماذا التحقق من الصحة باستخدام مخطط؟

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

مثال بسيط: مخطط أساسي

إليك كائن JSON أساسي، يليه مخطط مختصر يتحقق من صحة هيكله:

{
  "name": "أليس",
  "age": 30
}

{
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "age": { "type": "number" }
  },
  "required": ["name", "age"]
}

هذا المخطط يضمن أن الكائن يجب أن يحتوي على 'name' (كنص) و 'age' (كعدد).

كيف تكتب مخططًا مخصصًا

يمكنك تعريف قواعد متقدمة في مخططك: تقييد قيم الحقول، تعريف كائنات متداخلة، أو تحديد أرقام الحد الأدنى/الأقصى. إليك مثال يتحقق من صحة مصفوفة من المنتجات:

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": { "type": "string" },
      "price": { "type": "number", "minimum": 0 },
      "tags": {
        "type": "array",
        "items": { "type": "string" }
      }
    },
    "required": ["id", "price"]
  }
}

استخدام JSONValidator.dev للتحقق من المخططات

1. الصق بيانات JSON في المحرر الرئيسي.
2. الصق مخطط JSON في محرر المخطط أدناه.
3. انقر على تحقق من صحة JSON مقابل هذا المخطط.
4. راجع نتائج التحقق مع تمييز وتفسير أي أخطاء.

حل مشكلات أخطاء التحقق من المخطط

الأسباب الشائعة لأخطاء التحقق تشمل:

• غياب حقل مطلوب في بياناتك.
• نوع القيمة لا يتطابق مع المخطط (مثلاً نص مقابل عدد).
• المخطط نفسه غير صالح أو يحتوي على أخطاء مطبعية.

الخاتمة

التحقق من صحة مخطط JSON هو طريقة قوية لجعل بياناتك متينة وخالية من الأخطاء. جرب إنشاء مخطط لبياناتك الخاصة باستخدام مولد المخططات المجاني الخاص بنا JSON Schema Generator وتحقق منه مباشرة!