Scalar يحول ملف OpenAPI أو Swagger إلى مرجع تفاعلي، ويقدم عميل REST مبنيًا حول المواصفة نفسها. توجد تكاملات جاهزة مع أطر عديدة، ويمكن استضافة صفحة المرجع داخل المشروع.
لماذا اخترناه؟
لأنه يقلل المسافة بين الوثيقة والتجربة: القارئ يرى الـschemas والأمثلة ويستطيع إرسال طلب من السياق نفسه. والعميل offline-first مناسب للعمل على مواصفات خاصة دون ربط كل خطوة بخدمة خارجية.
التحفظ العملي
جمال الواجهة لا يصلح مواصفة ناقصة. جودة الناتج تظل مرتبطة بدقة OpenAPI، والأمثلة، ووصف الأخطاء والمصادقة. ثبّت المواصفة في CI قبل تحسين واجهة عرضها.
المصدر: scalar/scalar — رخصة MIT.