REST API چیست و چطور کار می‌کند؟ راهنمای عملی برای مبتدیان

API در یک جمله

اگر رابط برنامه‌نویسی (API) را ساده بخواهیم، پیشخدمتی است که سفارش شما را به آشپزخانه می‌برد و غذا را برمی‌گرداند؛ شما لازم نیست بدانید در آشپزخانه چه می‌گذرد، فقط باید سفارش را درست بدهید. حالا REST یک سبک مرسوم برای همین سفارش‌دادن است: مجموعه‌ای از قواعد که مشخص می‌کند چه چیزی را به کدام آدرس بفرستید و چه جوابی بگیرید؛ قواعدی که تقریباً کل وب روی آن‌ها بنا شده است.

وقتی می‌گوییم «کار با API»، در نود درصد موارد منظور همین REST است. خوشبختانه برای فهمیدنش لازم نیست معماری شبکه بخوانید؛ سه مفهوم کافی است: آدرس‌ها، متدها و پاسخ‌ها. این سه را که بفهمید، دنیای اتصال به سرویس‌های بیرونی برایتان باز می‌شود.

اجزای یک REST API

• آدرس یا Endpoint: هر سرویس، آدرس‌هایی مشخص برای هر نوع داده دارد؛ مثلاً آدرسِ جدا برای فهرست محصولات و جدا برای جزئیات یک محصول. مثل شماره‌های داخلی یک سازمان.
• متد: نوع کار شما را می‌گوید؛ خواندن، ساختن، تغییر یا حذف. متد GET برای گرفتن داده، POST برای فرستادن، PUT برای تغییر کامل و DELETE برای حذف.
• پارامترها: داده‌های ورودی شما؛ در GET معمولاً داخل خود آدرس می‌روند و در POST داخل بدنهٔ درخواست.
• پاسخ: سرویس، داده را تقریباً همیشه به فرمت JSON برمی‌گرداند؛ قالبی متنی که هم برای انسان خوانا است و هم برای برنامه.

متدها و کدهای وضعیت

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

• ۲۰۰ یعنی موفق: درخواست درست بود و داده آماده است؛ دوستِ همیشگی شما.
• ۲۰۱ یعنی ساخته شد: برای POSTهایی که موفق‌اند و چیزی جدید ساخته‌اند.
• ۴۰۰ یعنی تقصیر شماست: درخواست را بد فرستاده‌اید؛ مثلاً فیلد اجباری جا افتاده.
• ۴۰۱ و ۴۰۳ یعنی اجازه ندارید: یا وارد نشده‌اید یا اجازهٔ این کار را ندارید؛ کلید API را چک کنید.
• ۴۰۴ یعنی پیدا نشد: آدرس یا آن رکورد وجود ندارد؛ غلط‌ترین جا برای لجبازی با سرور است.
• ۵۰۰ یعنی تقصیر سرور است: کاری از دست شما برنمی‌آید؛ کمی صبر کنید و دوباره امتحان کنید.

اولین تجربهٔ عملی: یک API در مرورگر

بهترین بخش ماجرا این است که برای اولین تجربه، به هیچ کدی نیاز ندارید. مرورگر، خودش یک GET ساده می‌فرستد؛ پس یک API عمومیِ بدون کلید را در نوار آدرس باز کنید و Enter بزنید. صفحه‌ای پر از متن JSON می‌بینید: همین الان اولین درخواست API عمرتان را فرستادید!

حالا همین کار را در کد انجام دهید. در جاوااسکریپت مدرن، دریافت داده فقط چند خط است:

const res = await fetch(url);

const data = await res.json();

سپس JSON را باز کنید و با ساختارش بازی کنید؛ کلیدها و مقدارها را پیدا کنید و ببینید داده کجا نشسته است. وقتی این حس را گرفتید، سراغ پروژه‌های واقعی بروید: APIهای رایگان عمومی فهرستی از سرویس‌های تمرینیِ بی‌دردسر را معرفی کرده و پروژه‌های اولیهٔ برنامه‌نویسی نشان می‌دهد این داده‌ها را با چه پروژه‌هایی به نمونه‌کار تبدیل کنید.

از فهمیدن تا ساختن

فهمیدن REST فقط نیمهٔ راه است؛ نیمهٔ دوم، ساختن خودِ API است. وقتی پروژهٔ بک‌اند می‌سازید، شما همان کسی می‌شوید که آدرس‌ها را تعریف می‌کند و پاسخ‌ها را می‌فرستد؛ و در آن لحظه، دیدن دنیا از سمت سرور، کیفیت درخواست‌های سمت کلاینت شما را هم بالا می‌برد.

سه قاعدهٔ طلایی برای مسیر ادامه داشته باشید: اول، همیشه خطا را مدیریت کنید؛ سرورِ بی‌جواب بخشی از زندگی روزمرهٔ هر برنامه است. دوم، مستندات هر API را قبل از استفاده بخوانید؛ پنج دقیقه مطالعه، ساعت‌ها آزمون‌وخطا را حذف می‌کند. سوم، محدودیت درخواست‌ها را جدی بگیرید؛ احترام به سرویسِ رایگان، اخلاق حرفه‌ای است. با همین سه قاعده، اتصال به هر سرویسی که نامش را می‌شنوید، برایتان از ترسناک به هیجان‌انگیز تبدیل می‌شود.

بیشتر بخوانید

اگر این مطلب برایتان مفید بود، این‌ها را هم از دست ندهید:

• آموزش SQL از صفر؛ زبان پرس‌وجوی داده که هر برنامه‌نویسی لازم دارد
• پایتون یا جاوااسکریپت؟ مقایسهٔ کامل دو زبان محبوب در ۲۰۲۶