پیش‌نیازها

• توانایی ویرایش فایل‌های متنی

• آشنایی با RESTful API و فرمت JSON (مفید اما الزامی نیست)

توضیحات دوره

OpenAPI 3.0 یکی از مهم‌ترین ابزارها برای مستندسازی APIها محسوب می‌شود.

این فناوری که قبلاً با نام Swagger شناخته می‌شد، سابقه‌ای طولانی در دنیای توسعه نرم‌افزار دارد.

در سال ۲۰۱۰، Swagger به‌عنوان یک مشخصات متن‌باز برای طراحی و مستندسازی RESTful APIها معرفی شد.

در سال ۲۰۱۵، این پروژه توسط SmartBear Software خریداری شد و مشخصات Swagger به بنیاد Linux اهدا شد و با نام OpenAPI شناخته شد.

امروزه OpenAPI هسته یک اکوسیستم بزرگ متن‌باز است.

با جستجوی ابزارهای OpenAPI می‌توانید پروژه‌های متعددی برای تبدیل، مستندسازی، اعتبارسنجی، ویرایش، شبیه‌سازی سرور (Mock Server)، تست و موارد دیگر پیدا کنید.

با استفاده از مشخصات OpenAPI می‌توان کد سمت کلاینت را برای بیش از ۵۰ زبان برنامه‌نویسی و کد سمت سرور را برای بیش از ۴۰ زبان مختلف تولید کرد.

تمام این ابزارها از OpenAPI Specification شروع می‌شوند؛ موضوعی که در این دوره به‌صورت کامل بررسی می‌شود.

در ابتدای دوره، با مفهوم API، پروتکل HTTP و نحوه استفاده از آن در RESTful APIها آشنا می‌شوید. سپس به بررسی OpenAPI و کاربرد آن در مستندسازی APIها می‌پردازیم.

در ادامه، با استفاده از Swagger Hub شروع به نوشتن OpenAPI Specification می‌کنید. Swagger Hub یک ویرایشگر آنلاین رایگان و ساده برای Swagger و OpenAPI است.

در این دوره یک مشخصات کامل OpenAPI برای یک سرویس وب RESTful ایجاد خواهید کرد.

مهارت‌هایی که در دوره آموزش صفر تا صد OpenAPI یاد می‌گیرید

• ویرایش OpenAPI Specification در Swagger Hub

• تعریف مشخصات OpenAPI با YAML

• افزودن اطلاعات توسعه‌دهنده

• تعریف اطلاعات سرور

• تعریف مسیرهای API

• تعریف عملیات API

• ساخت آبجکت‌های استاندارد با JSON Schema

• استفاده از کامپوننت‌های قابل استفاده مجدد

• تعریف پارامترهای Query

• تعریف پارامترهای Path

• پیاده‌سازی عملیات GET، PUT، POST و DELETE

• تعریف مکانیزم‌های امنیتی API

• تولید کد با OpenAPI Code Generator

• تولید مستندات API با ReDoc

• تولید کد با OpenAPI Code Gen و Apache Maven

این دوره شامل تمرین‌ها و مثال‌های عملی متعددی است که به شما کمک می‌کند در نوشتن OpenAPI Specification مهارت پیدا کنید.

امکانات دوره

• دسترسی به جامعه خصوصی Slack برای پرسش و پاسخ

• زیرنویس انگلیسی برای تمام ویدیوها

• امکان دانلود فایل‌های PDF ارائه‌ها

دوره  آموزش صفر تا صد OpenAPI برای چه کسانی مناسب است؟

• افرادی که نیاز به کار با OpenAPI Specification دارند

• توسعه‌دهندگانی که باید APIهای خود را مستندسازی کنند

• تحلیل‌گران کسب‌وکار مسئول تهیه مشخصات API