آموزش Swagger و مشخصات OpenAPI را یاد بگیرید
Learn Swagger and the OpenAPI Specification
مشخصات OpenAPI (که اغلب "Swagger" نامیده می شود) در حال حاضر محبوب ترین راه برای ایجاد تعاریف RESTful API است. با این تعاریف، می‌توانید اسناد پیچیده و خودکار ایجاد کنید، SDKها را به چندین زبان تولید کنید و آزمایش‌های خودکار انجام دهید. Swagger مجموعه ای از ابزارهای منبع باز است که از این فایل های تعریف Open API Specification استفاده می کند.
این کلاس برای افرادی در صنعت نرم افزار است که نسبتاً فنی هستند، اما توسعه دهندگان نرم افزار نیستند: به عنوان مثال، مدیران پروژه، مدیران محصول API، و نویسندگان فنی. فرض بر این است که شما REST و JSON را می‌دانید، اما این همه چیز است. این برای افرادی است که به تازگی با مشخصات Open API و Swagger آشنا هستند، نه برای متخصصان. این موارد را پوشش می دهد:
چه کاری می توانید با فایل های OpenAPI Specification (OAS) انجام دهید
فرمت فایل YAML
نحوه ایجاد یک فایل OAS
نحوه تعیین امنیت
نحوه افزودن اسناد
نحوه نوشتن یک فایل OAS در JSON
جایگزین‌های Swagger و OAS
این کلاس شامل موارد زیر نمی شود:
نحوه راه اندازی Swagger در سرور خود
نحوه تغییر کد منبع باز Swagger
علاوه بر ویدیوها، این دوره شامل 8 تمرین عملی است که شما را به صورت گام به گام در ایجاد یک فایل تعریف API راهنمایی می کند، از جمله پروژه نهایی که در آن فایلی را از ابتدا با استفاده از مستندات یک API تجاری واقعی ایجاد می کنید. همچنین حاوی یک سند با منابعی در مورد یادگیری بیشتر در مورد OAS، Swagger، و جایگزین است.
علاوه بر سخنرانی‌های ویدیویی، حداقل 4 ساعت را برای انجام تمرین‌ها صرف کنید. این تمرین‌ها کلید درک Swagger و OAS هستند.
مهم: این دوره از OAS 2 استفاده می کند. نسخه جدیدتر، OAS 3، شروع به استفاده بیشتر می کند، اما بسیاری از شرکت ها هنوز از OAS 2 استفاده می کنند. یک سخنرانی وجود دارد که شما را به تفاوت های بین OAS 2 و OAS 3 اشاره می کند. .
معرفی Introduction
-
معرفی Introduction
-
تعریف API API Definition
-
YAML YAML
-
YAML YAML
-
YAML YAML
مشخصات API را باز کنید Open API Specification
-
نکاتی درباره OAS 3 و ویرایشگر Swagger Notes about OAS 3 and the Swagger editor
-
API Specification Basics را باز کنید Open API Specification Basics
-
اصول OAS OAS Basics
-
API Specification Basics را باز کنید Open API Specification Basics
-
طرحواره ها Schemas
-
طرحواره ها Schemas
-
طرحواره ها Schemas
-
باز کردن مشخصات API ادامه دارد Open API Specification Continued
-
باز کردن مشخصات API، ادامه دارد Open API Specification, Continued
-
باز کردن مشخصات API ادامه دارد Open API Specification Continued
-
مستندات Documentation
-
مستندات Documentation
ابزارها و جایگزین ها Tools and Alternatives
-
Swagger Tools Swagger Tools
-
SwaggerHub SwaggerHub
-
JSON JSON
-
همه را با هم قرار دهید Put It All Together
-
جایگزین های Swagger و OAS Alternatives to Swagger and OAS
-
Swagger for a Real World API Swagger for a Real World API
-
منابع Resources
-
سخنرانی جایزه: پیشنهادات برای دوره های دیگر Bonus Lecture: Offers for Other Courses
https://donyad.com/d/6322c0
Peter Gruenbaum
رئیس، پل SDK
نمایش نظرات