API مثل پیشخدمت یک رستوران است. شما (نرم‌افزار اول) سفارش را به پیشخدمت می‌دهید و او به آشپزخانه (نرم‌افزار دوم) می‌گوید و غذا را برمی‌گرداند. لازم نیست بدانید آشپزخانه چطور کار می‌کند؛ فقط باید بدانید منو چیست و چطور سفارش بدهید. API همان «منو و قواعد سفارش» بین دو برنامه است.
مثال‌های روزمره#
- اپلیکیشن هواشناسی از API یک سرویس هواشناسی دما را میگیرد.
- فروشگاه اینترنتی برای پرداخت با API درگاه بانکی صحبت می‌کند.
- سایت شما با API حمل‌ونقل، هزینه‌ی ارسال را حساب می‌کند.
- وقتی با ربات تلگرام کار می‌کنید، ربات از طریق API تلگرام پیام میگیرد و می‌فرستد.
یک درخواست ساده#
نرم‌افزار آدرس مشخصی را صدا می‌زند و جواب را معمولاً به‌شکل JSON میگیرد:
GET /api/products/12سرور اطلاعات محصول شماره‌ی ۱۲ را برمی‌گرداند.
چرا مهم است#
API باعث می‌شود نرم‌افزارها به هم وصل شوند و هر کدام روی کار خودش تمرکز کند. اپ موبایل و سایت می‌توانند از یک بک‌اند مشترک استفاده کنند. بسیاری از سرویسها، از جمله ابزارهای هوش مصنوعی، فقط از طریق API در دسترس برنامه‌نویس‌ها هستند.
نکات امنیتی#
بیشتر APIها کلید دسترسی دارند. این کلید مثل رمز عبور است؛ آن را در کد سمت مرورگر یا در مخزن عمومی کد نگذارید و در صورت لو رفتن فوراً عوضش کنید.