abulfadl.ahmadi
بازگشت به دوره‌ها
عملی و پروژه‌محور

دوره آموزشی API

از Postman و Python تا FastAPI

یادگیری عملی API با سناریوی یک فروشگاه آنلاین؛ ابتدا API را در Postman می‌آزماییم، سپس با Python فراخوانی می‌کنیم و در پایان بخشی از آن را با FastAPI می‌سازیم.

مدت
۳ جلسه عملی
پیش‌نیاز
Python مقدماتی
همراه داشته باشید
لپ‌تاپ شخصی
ثبت‌نام در دوره

هدف دوره

هدف حفظ تعریف‌ها نیست؛ یاد می‌گیرید مستندات را بخوانید، Request درست بسازید، Response و خطا را تحلیل کنید، احراز هویت انجام دهید و هر دو سمت Client و Server را بفهمید.

مناسب چه کسانی است؟

برای برنامه‌نویسان مقدماتی، علاقه‌مندان Web و Backend و کسانی که می‌خواهند API سرویس‌های پرداخت، پیامک، نقشه، شبکه‌های اجتماعی، سرویس‌های ابری یا هوش مصنوعی را در پروژه‌هایشان به کار بگیرند.

سناریوی مشترک سه جلسه

API یک فروشگاه آنلاین

با Resourceهای Products، Categories، Users، Authentication، Cart و Orders کار می‌کنیم تا هر مفهوم را روی یک سیستم منسجم ببینیم.

GET     /products
GET     /products/{id}
POST    /products
PATCH   /products/{id}
DELETE  /products/{id}

POST    /auth/login
GET     /users/me
POST    /cart/items
POST    /orders
Use → Understand → Implement → Build

مسیر و سرفصل سه جلسه

۱

جلسه ۱ — API، HTTP و کار عملی با Postman

شناخت ساختار API و ارسال Requestهای مختلف با استفاده از مستندات و Collection یک فروشگاه آنلاین.

مبانی API

  • Client، Server، API Consumer و API Provider
  • Resource، Endpoint، URL و Base URL
  • جایگاه API در معماری نرم‌افزار

HTTP و Request

  • HTTP و HTTPS و چرخه Request/Response
  • متدهای GET، POST، PUT، PATCH و DELETE
  • Headers، Query و Path Parameters، Body و Content-Type

Response و JSON

  • Status Code، Response Headers، Body و Response Time
  • Object، Array، انواع داده و ساختارهای تو در تو در JSON
  • تحلیل کدهای 2xx، 4xx و 5xx و پیدا کردن خطا

کار عملی با Postman

  • ساخت Request و ارسال Params، Headers و JSON Body
  • Collections، Import، Variables و Environments
  • بررسی Endpointهای Products، Categories، Cart و Orders

Authentication

  • تفاوت Authentication و Authorization
  • API Key، Token و Bearer Token
  • Login، دریافت Token و ارسال Authorization Header
۲

جلسه ۲ — کار با API در Python

تبدیل Requestهای آزمایش‌شده در Postman به یک برنامه Python واقعی و قابل اتکا.

Requests و دریافت داده

  • نصب و استفاده از کتابخانه requests
  • GET Request، Status Code و تبدیل Response به JSON
  • Query Parameters، Path Parameters و ساخت URL

تغییر داده

  • POST، PATCH و DELETE
  • ارسال JSON و Request Body
  • پردازش Dictionary، List، Nested Data و Array of Objects

امنیت و احراز هویت

  • Login، دریافت و نگهداری Token
  • API Key، Bearer Token و Authorization Header
  • Environment Variables، فایل .env، Secretها و .gitignore

یک Client مقاوم

  • مدیریت Status ناموفق، Connection Error، Timeout و Invalid Response
  • Exception Handling و رفتار مناسب هنگام خطا
  • Pagination با Page، Limit، Offset و Cursor و مدیریت Rate Limit 429

سناریوی عملی

  • دریافت و جست‌وجوی محصولات
  • ورود و ارسال Request احرازشده
  • افزودن محصول به سبد خرید و ایجاد سفارش
۳

جلسه ۳ — ساخت API با FastAPI

تجربه نقش API Provider با ساخت بخشی از Backend فروشگاه و اتصال دوباره آن به Postman و Python.

شروع FastAPI

  • Web Framework و معرفی FastAPI
  • ایجاد پروژه، نصب وابستگی‌ها و Development Server
  • ساخت اولین Endpoint و شناخت Routeها

Products API

  • ساخت GET، POST، PATCH و DELETE برای محصولات
  • Path و Query Parameters
  • دریافت Request Body و بازگرداندن JSON

Validation و Response

  • Modelها، Type Hints و فیلدهای Required و Optional در Pydantic
  • اعتبارسنجی ورودی و مشاهده Validation Error
  • Status Codeهای 200، 201، 204 و 404 و Error Handling

OpenAPI و Swagger

  • API Schema و مستندات خودکار FastAPI
  • مشاهده Parameters، Request Body و Response Schema
  • آزمایش Endpointها از داخل Swagger UI

پروژه پایانی

  • اجرای Products API ساخته‌شده
  • اتصال Postman به برنامه FastAPI
  • اتصال اختیاری Python Client و مشاهده چرخه کامل Client/Server
ابزارها و فناوری‌ها

جعبه‌ابزار دوره

HTTP / HTTPS
REST API
JSON
Postman
Python
Requests
Environment Variables
.env
FastAPI
Pydantic
OpenAPI
Swagger UI

پیش‌نیاز و آماده‌سازی

آشنایی مقدماتی با متغیرها، انواع داده، شرط، حلقه، تابع، List، Dictionary و Import در Python توصیه می‌شود. تجربه قبلی API یا Backend لازم نیست. پیش از دوره Python، Postman و یک Code Editor یا IDE را نصب کنید.

دستاورد نهایی

خواندن مستندات یک API جدید
انتخاب Endpoint و HTTP Method مناسب
ساخت Request با Parameters، Headers و Body
آزمایش API با Postman
فراخوانی API در Python
پردازش JSON و مدیریت خطا
پیاده‌سازی Authentication
ساخت یک API ساده با FastAPI

آماده‌اید چرخه کامل API را تجربه کنید؟

از خواندن مستندات و ارسال Request تا پردازش Response و ساخت Endpoint در سمت Server.

ثبت‌نام در دوره همه دوره‌ها