2026-11-01
کلمهی API رو هر روز میشنوی: «برو API رو صدا بزن»، «این سرویس API داره»، «API جواب نمیده». ولی کسی نیست بهت بگه دقیقاً یعنی چی. بیا با یه رستوران توضیحش بدیم.
تو وارد رستوران میشی. آشپزخونه رو نمیبینی و لازم هم نیست ببینی. فقط منو داری و گارسون.
حالا همین رو به دنیای نرمافزار ترجمه کن:
| رستوران | نرمافزار | |---|---| | مشتری | اپلیکیشن شما (مثلاً موبایل) | | گارسون | API | | آشپزخونه | سرور و دیتابیس | | منو | مستندات API |
API یعنی راه ارتباط مشخص بین دو نرمافزار. یکی درخواست میده، اون یکی جواب برمیگردونه، بدون اینکه لازم باشه درون هم رو ببینن.
وقتی اپلیکیشن آبوهوا رو باز میکنی، خودش دما رو نمیدونه. به یه سرور درخواست میده:
GET /weather?city=tehran
سرور جواب میده:
{ "city": "tehran", "temp": 18, "sky": "clear" }
اپلیکیشن همین رو قشنگ نشونت میده. همینقدر ساده.
۱. Request (درخواست): چیزی که میفرستی. شامل آدرس، نوع کار و گاهی اطلاعات.
۲. Response (پاسخ): چیزی که برمیگرده. معمولاً دادهها به شکل JSON.
۳. Method (نوع کار): چهار تای رایج:
GET ← بخونPOST ← بسازPUT / PATCH ← ویرایش کنDELETE ← پاک کن۴. Status Code (کد وضعیت): عددی که میگه چی شد. 200 یعنی موفق، 404 یعنی پیدا نشد، 401 یعنی اجازه نداری، 500 یعنی سرور خودش خراب شد.
REST یه روش مرتبنویسی APIهاست. مثلاً برای کاربرها:
GET /users ← لیست کاربرهاGET /users/5 ← کاربر شماره ۵POST /users ← کاربر جدیدDELETE /users/5 ← حذف کاربر ۵آدرسها اسم چیزها هستن، و نوع کار با Method مشخص میشه. همین باعث میشه هر برنامهنویسی با دیدن API بفهمه چی به چیه.
وقتی اولین API خودت جواب بده و بتونی با مرورگر ببینیش، اون لحظه واقعاً حس میکنی برنامهنویس شدی.
میخوای بیشتر بدونی؟ مسیر «مسیر تخصصی Backend Developer با Python و FastAPI» رو رجیستر کن.
برای یادگیری عملیتر: مسیر تخصصی Backend Developer با Python و FastAPI