اگر هنوز از یک زبان تعریف برای مشخصات API قابل خواندن توسط ماشین، مانند OpenAPI (که قبلاً Swagger نامیده می شد) استفاده نمی کنید، قطعاً باید این کار را در نظر بگیرید. به هر حال، APIها زبانی هستند که ماشین ها با یکدیگر صحبت می کنند.
آیا Swagger ایده خوبی است؟
Swagger تأثیر اولیه بسیار خوبی را ایجاد می کند علاوه بر این، بسیاری از مردم فکر می کنند که امکان تولید کد از اسناد ایده خوبی است و Swagger این را ارائه می دهد. همچنین. بنابراین این واقعیت که swagger تأثیر اولیه خوبی می گذارد، محدودیت ها و محدودیت های آن را کمتر آشکار می کند.
هدف از استفاده از Swagger چیست؟
Swagger به شما امکان می دهد ساختار API های خود را توصیف کنید تا ماشین ها بتوانند آنها را بخوانند. توانایی APIها برای توصیف ساختار خود ریشه همه شگفتی‌های Swagger است.
آیا Swagger هنوز استفاده می شود؟
امروزه، بسیاری از کاربران هنوز از عبارات " Swagger" برای ارجاع به فرمت مشخصات OpenAPI 2.0 و "Swagger spec" برای ارجاع به سند توضیحات API در این قالب استفاده می کنند.. RepreZen API Studio از این اصطلاحات در برخی از بخش‌های رابط کاربری استفاده می‌کند، اما به OpenAPI 3.0 و نسخه‌های جدیدتر به عنوان "OpenAPI" اشاره می‌کند.
آیا swagger فقط برای REST API است؟
مشخصات OpenAPI (مشخصات Swagger سابق) یک قالب توضیح API برای REST APIs است. یک فایل OpenAPI به شما امکان می دهد کل API خود را توصیف کنید، از جمله: نقاط پایانی موجود (/users) و عملیات در هر نقطه پایانی (GET /users، POST /users)
