المخطط أولًا والأمر ثانيًا

ما هي الحركة

اكتب مخطط المخرجات قبل التعليمة. عندئذٍ لا يبقى على الأمر إلا وصف الحكم، لأن الشكل مفروض أصلًا.

لماذا تنجح

طلب JSON رجاء، وإرسال مخطط قيد. وحين يُضمن الشكل يصير الأمر أقصر وأوضح لأنه يكفّ عن وصف التنسيق.

خطوة خطوة

1. اكتب المخطط بوصفه تعريف عقد الخطوة، مسطّحًا لا عميق التداخل.
2. مرّره معامل المخرجات المهيكلة لا نصًا داخل الأمر.
3. اكتب التعليمة عن القرار وحده: ما الذي يجعل هذا الحقل صحيحًا.
4. عالج الرفض ورفض السلامة والقطع فروعًا منفصلة عن فشل التحليل.
5. تحقّق من القيم عند الحدود على أي حال.

الصق هذا

المخطط مُرسَل مع الطلب، فلا تكرّره ولا تُحِط الكائن بأي نص. احكم في شيء واحد: <ما الذي يجعل كل حقل صحيحًا>، ولا تعتمد على غير <المصدر>. وإن غابت القيمة فاستعمل حقل notFound بدل اختراعها.

كيّفها لك

أضف حقلًا إلزاميًا للثقة أو لعدم الوجود، ليملك النموذج طريقة مشروعة ليقول لا أعرف بدل اختراع قيمة تُرضي الشكل.

تنويعات

• أضف حقل «دليل» نصيًا يحمل الاقتباس الذي جاءت منه القيمة.
• اجعل كل حقل اختياري إلزاميًا بقيمة null صريحة بدلًا من ذلك.

يعمل مع

• احصل على JSON يطابق مخططك دائمًا