معرفی جلسه

به جلسهٔ تمرینی دورهٔ انجنیری هوش مصنوعی نهاد آموزشی افغان گیکس خوش آمدید.

در جلسهٔ سوم با مفهوم API آشنا شدیم و نخستین درخواست خود را به Gemini API و Ollama API ارسال کردیم. اما همان‌گونه که در تمرین‌های عملی دیدیم، درک واقعی شیوهٔ کار یک API — به‌ویژه بخش کد Node.js — برای بسیاری از محصلان هنوز به تمرین بیشتر نیاز دارد.

این جلسه یک جلسهٔ تمرینی و تثبیتی است. به‌جای آموزش مفاهیم جدید، این بار همان کدی را که در جلسهٔ سوم نوشتیم، عمیق‌تر بررسی می‌کنیم — خط به خط، با مثال‌های ساده از زندگی روزمرهٔ افغانستان.

به‌جای نمایش یک کد کامل و آماده، در این جلسه کد را مرحله به مرحله و در برابر چشمان شما می‌سازیم — و هر بار که خطایی رخ می‌دهد، آن را با هم بررسی و حل می‌کنیم. آموختن از خطا، یکی از مؤثرترین روش‌های یادگیری برنامه‌نویسی است.

همچنان از چند محصل خواهش می‌کنیم که صفحهٔ نمایش خود را با صنف شریک بسازند تا کد را با هم اجرا کنیم و مشکلات رایج را به‌صورت زنده بررسی نماییم. هدف این جلسه آن است که همهٔ محصلان، بدون استثنا، مطمئن شوند که مفهوم API و شیوهٔ استفاده از آن را به‌صورت کامل درک کرده‌اند — پیش از آن‌که به مباحث پیچیده‌تر برویم.

در این جلسه چه خواهید آموخت؟

• تشبیه ساده: API چیست؟ (مانند سفارش دادن غذا در رستورانت یا ارسال حواله)

• بررسی خط به خط کد fetch — هر خط چه کاری انجام می‌دهد؟

• تفاوت میان method، headers و body در یک درخواست

• چرا باید از await استفاده کنیم؟ اگر آن را حذف کنیم، چه رخ می‌دهد؟

• دیدن پاسخ خام (raw JSON) پیش از استخراج داده‌های مورد نیاز

• ۵ خطای رایج هنگام کار با API و شیوهٔ عیب ‌یابی آن‌ها

• تمرین عملی: هر محصل به‌صورت زنده کد را اجرا و اصلاح می‌کند

• چک ‌لیست عیب‌یابی — اگر کد کار نکرد، این ۵ نکته را بررسی کنید

این جلسه برای چه کسانی مناسب است؟

• محصلانی که در جلسهٔ سوم با کد API مشکل داشتند

• محصلانی که می‌خواهند پیش از جلسهٔ بعدی، مفهوم API را به ‌صورت کامل تثبیت کنند

• کسانی که کد را اجرا کرده‌اند، اما نمی ‌دانند دقیقاً چرا کار می‌کند

• محصلانی که با خطاهای غیرمنتظره روبه ‌رو شده‌اند و نمی ‌دانند چگونه آن‌ها را حل کنند

• هر محصلی که می‌خواهد پیش از ورود به مباحث پیشرفته ‌تر، بنیاد محکمی داشته باشد

نکته : این جلسه را اختیاری نپندارید — به همهٔ محصلان، حتی آنانی که فکر می‌کنند مفهوم را به‌ خوبی فهمیده‌اند، به ‌گونهٔ جدی توصیه می‌شود که در این جلسه شرکت کنند. تثبیت بنیاد، سرعت یادگیری را در جلسات آینده چند برابر می‌سازد.