کدلپر - مرجع جامع آموزش برنامه‌نویسی

All Right Reserved © 2025 Codoloper

background codoloper

HTML - Web API

خانه
 

HTML - Web API چیست؟

Web API رویای یک توسعه‌دهنده است.

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

  • می‌تواند توابع پیچیده را به شدت ساده‌سازی کند.

  • می‌تواند سینتکس (قواعد نوشتاری) ساده‌ای برای کدهای پیچیده فراهم کند.


Web API چیست؟

API مخفف Application Programming Interface (رابط برنامه‌نویسی اپلیکیشن) است. یک API نوعی رابط است که شامل مجموعه‌ای از توابع و زیرروال‌ها است که به برنامه‌نویسان اجازه می‌دهد به ویژگی‌ها یا داده‌های خاص یک اپلیکیشن، سیستم‌عامل یا سایر سرویس‌ها دسترسی پیدا کنند. یک Web API یک رابط برنامه‌نویسی اپلیکیشن برای وب است.


APIهای HTML

همه مرورگرها مجموعه‌ای از Web APIهای داخلی برای پشتیبانی از عملیات پیچیده و کمک به دسترسی به داده‌ها دارند. در اینجا برخی از APIهای اصلی HTML5 آورده شده است:

  1. API موقعیت‌یابی جغرافیایی (Geolocation API) - این API برای دسترسی به موقعیت مکانی فعلی کاربر (با طول و عرض جغرافیایی) استفاده می‌شود.

  2. API کشیدن و رها کردن (Drag and Drop API) - این API شما را قادر می‌سازد تا از ویژگی‌های کشیدن و رها کردن در مرورگرها استفاده کنید.

  3. API ذخیره‌سازی وب (Web Storage API) - این API مکانیزم‌هایی دارد که به مرورگرها اجازه می‌دهد زوج‌های کلید/مقدار را ذخیره کنند (به روشی ملموس‌تر از کوکی‌ها).

  4. API کارگران وب (Web Workers API) - این API به یک اسکریپت جاوااسکریپت اجازه می‌دهد تا در پس‌زمینه اجرا شود، بدون اینکه بر عملکرد صفحه تأثیر بگذارد. کاربران می‌توانند به انجام هر کاری که می‌خواهند ادامه دهند: کلیک کردن، انتخاب موارد و غیره، در حالی که web worker در پس‌زمینه اجرا می‌شود.

  5. API رویدادهای ارسالی از سرور (Server-Sent Events API) - این API به یک صفحه وب اجازه می‌دهد تا به طور خودکار به‌روزرسانی‌ها را از یک سرور دریافت کند.

  6. API بوم نقاشی (Canvas API) - این API به شما امکان می‌دهد تا به صورت پویا (on the fly)، از طریق جاوااسکریپت، گرافیک ترسیم کنید.


نکاتی در مورد استفاده از APIهای HTML

هنگام پیاده‌سازی یک API در HTML، شما همیشه باید:

  • بررسی قابلیت مرورگر - همیشه بررسی کنید که مرورگرهای هدف از آن API پشتیبانی می‌کنند. همیشه یک اسکریپت یا پیام برای اجرا در صورتی که مرورگر از آن پشتیبانی نمی‌کند، اضافه کنید.

  • افزودن مدیریت خطای قوی - برای رسیدگی به سناریوهایی که یک API ممکن است طبق انتظار عمل نکند، مدیریت خطای قوی اضافه کنید تا از یک تجربه کاربری یکپارچه اطمینان حاصل شود.

  • درخواست اجازه کاربر - هنگام استفاده از یک API که به داده‌های حساس دسترسی دارد، مانند API موقعیت‌یابی جغرافیایی (که به موقعیت جغرافیایی کاربر دسترسی پیدا می‌کند)، همیشه قبل از ادامه کار از کاربر برای رضایت او سؤال کنید.


APIهای شخص ثالث (Third Party)

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

  • API یوتیوب - به شما امکان می‌دهد ویدیوها را در یک وب‌سایت نمایش دهید.

  • API توییتر - به شما امکان می‌دهد توییت‌ها را در یک وب‌سایت نمایش دهید.

  • API فیسبوک - به شما امکان می‌دهد اطلاعات فیسبوک را در یک وب‌سایت نمایش دهید.