Format Atlas

أدلة

اختيار تنسيقات بيانات الويب والإعدادات

فكر في JSON للتبادل الآلي مثل واجهات API، وYAML للإعدادات التي يحررها البشر، وXML للتكاملات القائمة على مخططات موجودة.

أي تنسيق يجب أن تختار؟

اختر وفق دور كل ملف في سير عملك.

  • واجهات الويب → JSON
  • إعدادات يحررها البشر → YAML
  • مخطط أو عقد قائم → XML

استخدم التنسيق الذي يطلبه المستلم

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

تنسيقات مقترحة

JSON

مناسب لـ: واجهات API والتبادل القائم على JSON

أقل ملاءمة لـ: إعدادات يدوية تتطلب تعليقات

YAML

مناسب لـ: إعدادات يصونها البشر

أقل ملاءمة لـ: واجهات لا تقبل إلا JSON

XML

مناسب لـ: مخططات وتكاملات XML القائمة

أقل ملاءمة لـ: واجهات جديدة بسيطة بلا متطلبات XML

تحقق قبل التصدير

  • لا تفترض أن YAML مجموعة شاملة صارمة تتضمن JSON بالكامل.
  • أكد الترميز والأنواع ومعالجة المخططات مع المستلم.

مقارنات ذات صلة

أدلة

المراجع والمواصفات