HTML – What is a Web API?

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

نکات کلیدی:

• وب API بخشی از HTML نیست، اما معمولاً در کنار آن و از طریق جاوااسکریپت استفاده می‌شود.

• وب APIها این امکان را می‌دهند که بتوانید با ویژگی‌های مرورگر ارتباط برقرار کنید یا به سرویس‌های خارجی متصل شوید.

• آن‌ها برای ساخت وب‌سایت‌های پویا و تعاملی ضروری هستند.

انواع Web API:

۱. APIهای مرورگر (Browser APIs) – درون مرورگر ساخته شده‌اند و قابلیت‌هایی را به جاوااسکریپت می‌دهند:

• DOM API – برای دسترسی و تغییر ساختار HTML.

• Fetch API – برای ارسال درخواست‌های HTTP (مثل دریافت داده از سرور).

• Geolocation API – برای گرفتن موقعیت جغرافیایی کاربر.

• Canvas API – برای رسم گرافیک و انیمیشن.

• LocalStorage / SessionStorage – برای ذخیره داده در مرورگر کاربر.

۲. APIهای شخص ثالث (Third-Party APIs) – توسط سرویس‌های خارجی ارائه می‌شوند (مانند Google Maps یا Twitter API):

• معمولاً از طریق درخواست‌های HTTP (مثل REST یا GraphQL) استفاده می‌شوند.

• پاسخ‌ها اغلب به صورت JSON بازمی‌گردند.

مثال: استفاده از Fetch API

fetch(‘https://api.example.com/data’)
.then(response => response.json())
.then(data => {
console.log(data); // پردازش داده دریافتی از API
})
.catch(error => {
console.error(‘خطا:’, error);
});