API یعنی چه؟
تلفظ: اِیپیآی · نوع: مخفف · مخفف: Application Programming Interface
معنی API: راه رسمی حرف زدن یک برنامه با برنامهی دیگر
API راهی است که یک برنامه در اختیار برنامههای دیگر میگذارد تا از آن چیزی بخواهند. interface یعنی «جای تماس دو چیز»: آدمها با دکمه و صفحه با یک برنامه کار میکنند، برنامهها با API. مثل منوی رستوران است: لازم نیست بدانی در آشپزخانه چه میگذرد؛ از روی منو سفارش میدهی و غذا میآید. مثلاً اپ هواشناسی گوشی خودش هوا را اندازه نمیگیرد: به API یک سرویس هواشناسی میگوید «هوای تهران؟» و جواب را به شکل داده میگیرد. منو (یعنی این که چه میشود خواست و چطور) در مستندات API نوشته شده است.
API در جمله
We use a weather API to show the temperature in the app.
برای نشان دادن دما در برنامه از یک API هواشناسی استفاده میکنیم.
API در کد
import requests
r = requests.get("https://api.example.com/weather?city=Tehran")
print(r.json()) # {"city": "Tehran", "temp": 21}برنامهی تو سؤال میپرسد و API بهجای صفحهی زیبا، دادهی خام میدهد.
نکته
حرفبهحرف خوانده میشود: اِی، پی، آی. جمعش APIs است. API فقط مال وب نیست: به تابعهایی که یک کتابخانه در اختیارت میگذارد هم API آن کتابخانه میگویند.
کلمههای مرتبط
- endpoint: نشانی یک کار مشخص در API
- request: درخواست؛ پیامی که کلاینت به سرور میفرستد
- JSON: قالبی متنی و ساده برای نوشتن و فرستادن داده
درس این کلمه
API یکی از هشت کلمهی درس «API» در فاز 4: وب و API از دورهی انگلیسی برای برنامهنویسها است. بقیهی کلمههای این درس:
- endpoint: نشانی یک کار مشخص در API
- REST: سبکی ساده و رایج برای ساختن API روی HTTP
- JSON: قالبی متنی و ساده برای نوشتن و فرستادن داده
- XML: قالبی تگدار برای نوشتن داده، قدیمیتر از JSON
- payload: بار اصلی پیام؛ دادهای که واقعاً میفرستی
- query string: تکهی بعد از علامت سؤال در نشانی
- resource: منبع؛ هر چیزی که API به تو میدهد یا نگه میدارد