API چیه؟ با مثال رستوران بفهم

2026-11-01

کلمه‌ی API رو هر روز می‌شنوی: «برو API رو صدا بزن»، «این سرویس API داره»، «API جواب نمی‌ده». ولی کسی نیست بهت بگه دقیقاً یعنی چی. بیا با یه رستوران توضیحش بدیم.

رستوران و API

تو وارد رستوران می‌شی. آشپزخونه رو نمی‌بینی و لازم هم نیست ببینی. فقط منو داری و گارسون.

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

| رستوران | نرم‌افزار | |---|---| | مشتری | اپلیکیشن شما (مثلاً موبایل) | | گارسون | API | | آشپزخونه | سرور و دیتابیس | | منو | مستندات API |

API یعنی راه ارتباط مشخص بین دو نرم‌افزار. یکی درخواست می‌ده، اون یکی جواب برمی‌گردونه، بدون اینکه لازم باشه درون هم رو ببینن.

یه مثال واقعی

وقتی اپلیکیشن آب‌وهوا رو باز می‌کنی، خودش دما رو نمی‌دونه. به یه سرور درخواست می‌ده:

GET /weather?city=tehran

سرور جواب می‌ده:

{ "city": "tehran", "temp": 18, "sky": "clear" }

اپلیکیشن همین رو قشنگ نشونت می‌ده. همین‌قدر ساده.

چهار چیزی که باید بشناسی

۱. Request (درخواست): چیزی که می‌فرستی. شامل آدرس، نوع کار و گاهی اطلاعات.

۲. Response (پاسخ): چیزی که برمی‌گرده. معمولاً داده‌ها به شکل JSON.

۳. Method (نوع کار): چهار تای رایج:

۴. Status Code (کد وضعیت): عددی که می‌گه چی شد. 200 یعنی موفق، 404 یعنی پیدا نشد، 401 یعنی اجازه نداری، 500 یعنی سرور خودش خراب شد.

REST یعنی چی؟

REST یه روش مرتب‌نویسی API‌هاست. مثلاً برای کاربرها:

آدرس‌ها اسم چیزها هستن، و نوع کار با Method مشخص می‌شه. همین باعث می‌شه هر برنامه‌نویسی با دیدن API بفهمه چی به چیه.

چرا برنامه‌نویس‌ها اینقدر ازش حرف می‌زنن؟

از کجا شروع کنم؟

  1. یه API عمومی پیدا کن و با ابزار ساده‌ای مثل مرورگر صداش بزن.
  2. شکل JSON رو یاد بگیر.
  3. با پایتون یه API کوچیک بساز؛ فقط دو سه آدرس.
  4. بعد وصلش کن به دیتابیس.

وقتی اولین API خودت جواب بده و بتونی با مرورگر ببینیش، اون لحظه واقعاً حس می‌کنی برنامه‌نویس شدی.

می‌خوای بیشتر بدونی؟ مسیر «مسیر تخصصی Backend Developer با Python و FastAPI» رو رجیستر کن.

برای یادگیری عملی‌تر: مسیر تخصصی Backend Developer با Python و FastAPI