آموزش ساخت API ها با Swagger و مشخصات OpenAPI

مقدمه Introduction

• ساخت API ها با Swagger Building APIs with Swagger

• آنچه شما باید بدانید What you should know

• نمای کلی پروژه نمایشی Demo project overview

• به روزرسانی های این دوره Updates to this course

1. اکوسیستم Swagger 1. Swagger Ecosystem

• اکوسیستم Swagger Swagger ecosystem

• ابزارهای منبع باز Open-source tools

• مشخصات OpenAPI OpenAPI Specification

• نصب ابزار منبع آزاد Open-source tool installation

• مقدمه H + Sport H+ Sport intro

• ساخت یک API ساده Building a simple API

• چالش: بازیابی پست های وبلاگ شرکت Challenge: Retrieve company blog posts

• راه حل: بازیابی پست های وبلاگ شرکت Solution: Retrieve company blog posts

2. مشخصات مشخصات API 2. Building API Specifications

• تعریف API ها Defining APIs

• خواندن مشخصات Reading the specification

• مسیرهایی با پارامترهای جستجو Paths with query parameters

• پارامترهای الگو در مسیرها Template parameters in paths

• ایجاد پست با بدن درخواست Building posts with request bodies

• دستیابی به قابلیت استفاده مجدد با م componentsلفه ها Achieving reusability with components

• اشیا Resp پاسخ Response objects

• استفاده مجدد از پارامترها Reusing parameters

• مذاکره در مورد محتوا Content negotiation

• رابط کاربری Swagger Swagger UI

• چالش: ایجاد پست های وبلاگ شرکت Challenge: Create company blog posts

• راه حل: ایجاد پست های وبلاگ شرکت Solution: Create company blog posts

3. ایجاد و انتشار API با SwaggerHub 3. Creating and Publishing APIs with SwaggerHub

• ساخت API در SwaggerHub Building APIs within SwaggerHub

• شروع کار با SwaggerHub Getting started with SwaggerHub

• ساخت تعاریف API از الگوها Building API definitions from templates

• نسخه دهی API ها در SwaggerHub Versioning APIs in SwaggerHub

• وارد کردن تعاریف API Importing API definitions

• طرح های امنیتی Security schemes

• دامنه ها Domains

• طرح های تودرتو در دامنه ها Nesting schemas in domains

• اجرای استانداردهای API Enforcing API standards

• رابط برنامه نویسی خودکار Auto Mocking APIs

• افزودن اعضای سازمان Adding organization members

• دعوت از همکاران فردی Inviting individual collaborators

• چالش: انتشار API وبلاگ Challenge: Publish the blog API

• راه حل: انتشار API وبلاگ Solution: Publish the blog API

4. پروژه Capstone 4. Capstone Project

• معماری پروژه Project architecture

• تولید مقاله های خرد سرور و SDK مشتری Generating server stubs and client SDKs

• ساخت مشتری API Building an API client

• داخلی SDK مشتری Client SDK internals

• پیاده سازی API API implementation

• بسته بندی اجرای API Packaging the API implementation

• میزبان API ها در Azure Hosting APIs in Azure

• راه اندازی سرور API API server setup

• انتشار API های عمومی Publishing public APIs

• مدیریت API با Apigee API management with Apigee

• نظارت بر استفاده از API Monitoring API usage

• تغییرات مشتری Client modifications

نتیجه Conclusion

• مراحل بعدی Next steps