إذا كنت لا تزال لا تستخدم لغة تعريف لمواصفات واجهة برمجة التطبيقات التي يمكن قراءتها آليًا ، مثل OpenAPI (المعروف سابقًا باسم Swagger) ، فعليك بالتأكيد التفكير في القيام بذلك. بعد كل شيء ، واجهات برمجة التطبيقات هي لغات للآلات للتحدث مع بعضها البعض.
هل Swagger فكرة جيدة؟
يقدم Swagger انطباعًا أوليًا جيدًا جدًا بالإضافة إلى ذلك ، يعتقد الكثير من الناس أن إمكانية إنشاء رمز من الوثائق فكرة جيدة ويوفر Swagger ذلك كذلك. لذا فإن حقيقة أن اختيال يجعل الانطباع الأول رائعًا ، يجعل حدوده وقيوده أقل وضوحًا.
ما هو الغرض من استخدام Swagger؟
Swagger يسمح لك بوصف هيكل واجهات برمجة التطبيقات الخاصة بك حتى تتمكن الآلات من قراءتها. إن قدرة واجهات برمجة التطبيقات على وصف هيكلها الخاص هي أصل كل الذهول في Swagger.
هل لا يزال Swagger مستخدمًا؟
اليوم ، لا يزال العديد من المستخدمين يستخدمون المصطلحات " Swagger" للإشارة إلى تنسيق مواصفات OpenAPI 2.0، و "مواصفات Swagger" للإشارة إلى مستند وصف API بهذا التنسيق. يستخدم RepreZen API Studio هذه المصطلحات في بعض أجزاء واجهة المستخدم ، لكنه يشير إلى OpenAPI 3.0 والإصدارات الأحدث كـ "OpenAPI. "
هل اختيال فقط لواجهة برمجة تطبيقات REST؟
مواصفات OpenAPI (مواصفات Swagger سابقًا) هي تنسيق وصف API لواجهات برمجة تطبيقات REST. يتيح لك ملف OpenAPI وصف واجهة برمجة التطبيقات بالكامل ، بما في ذلك: نقاط النهاية المتاحة (/ المستخدمين) والعمليات على كل نقطة نهاية (GET / المستخدمين ، POST / المستخدمين)
