معرفی API: چطور سایتت رو به دنیا وصل کنی؟

اگر داری تو دنیای برنامه‌نویسی وب قدم برمیداری، حتما اسم API رو شنیدی. ولی ممکنه هنوز نفهمی دقیقاً چیه و چرا همه ازش استفاده می‌کنن. تو این مقاله قراره یاد بگیری API چیه، چرا مهمه و چطور میتونی ازش توی سایت‌ت استفاده کنی. مهم نیست که شروع کاری هستی یا یه حرفه‌ای، API یه چیزه که نمیشه بدونش کار کرد.

API چیه؟

API اختصار عبارت Application Programming Interface هست و یه راه ارتباطی بین دو سیستم یا سرویس هست. به زبون ساده، API بهت اجازه میده با یه سایت یا سرویس دیگه صحبت کنی و دیتا بگیری یا بفرستی.

فرض کن میخوای توی سایتت اطلاعات هواشناسی نمایش بدی. بدون API، باید خودت داده‌ها رو جمع‌آوری میکردی. ولی با API، میتونی از یه سرویس مثل OpenWeatherMap درخواست دیتا کنی و خودش بهت اطلاعات رو میده!

چرا API مهمه؟

• دریافت دیتای خارجی: مثل اخبار، هوا، قیمت سهام و ...
• ارتباط با سرویس‌های دیگه: مثل پرداخت آنلاین، لاگین با گوگل، اشتراک‌گذاری در شبکه‌های اجتماعی
• به اشتراک گذاشتن دیتا: اگر سایتی داری که دیتا داره، میتونی اون رو با دیگران به اشتراک بذاری.
• کار کردن با سرویس‌های مدرن: مثل ChatGPT, Google Maps, Twitter, Instagram و ...
• استفاده در SPA و موبایل: بیشتر اپ‌ها با API کار میکنن.

چطور API کار می‌کنه؟

API یه رابط بین کلاینت (سایت تو) و سرور (سرویس خارجی) هست. وقتی یه درخواست میفرستی، سرور یه پاسخ میده — مثلاً یه لیست از اخبار یا یه خطای امنیتی.

درخواست (Request)

درخواست میتونه از نوع‌های مختلفی باشه:

• GET: دیتا دریافت کنیم
• POST: دیتا بفرستیم
• PUT: دیتا رو بروزرسانی کنیم
• DELETE: دیتا رو پاک کنیم

پاسخ (Response)

پاسخ معمولاً به شکل JSON یا XML هست. مثلاً یه پاسخ JSON از یه API هوا میتونه اینجوری باشه:

{
  "city": "تهران",
  "temperature": 25,
  "description": "آسمان صاف",
  "humidity": "40%"
}

مثال عملی: دریافت دیتا از یه API عمومی

خب حالا بیا یه مثال ساده ببینیم. میخوایم از یه API عمومی مثل JSONPlaceholder لیست پست‌ها رو بگیریم.

fetch('https://jsonplaceholder.typicode.com/posts ')
  .then(response => response.json())
  .then(posts => console.log(posts));

این کد یه لیست از پست‌ها رو از سرور می‌گیره و توی کنسول مرورگر نمایش میده. فقط با یه خط URL و چند خط جاوااسکریپت، دیتا رو از دنیای بیرون گرفتی!

چطور API رو توی سایت استفاده کنیم؟

خب حالا که فهمیدی چطور API کار میکنه، بیا یه مثال کاربردی ببینیم:

1. نمایش لیست کاربرها

fetch('https://jsonplaceholder.typicode.com/users ')
  .then(response => response.json())
  .then(users => {
    const userList = document.getElementById('user-list');
    users.forEach(user => {
      const li = document.createElement('li');
      li.textContent = user.name;
      userList.appendChild(li);
    });
  });

و توی HTML:

این کد یه لیست از کاربرها رو از API بیرون می‌کشه و توی صفحه نمایش میده.

چند نکته مهم در کار با API

• توکن امنیتی: بعضی API ها نیاز به کلید (API Key) دارن.
• محدودیت درخواست: بعضی سرویس‌ها تعداد درخواست‌ها رو محدود میکنن.
• خطاها: همیشه خطاهای API رو بررسی کن:

fetch('https://api.example.com/data ')
  .then(response => {
    if (!response.ok) {
      throw new Error('خطا در دریافت دیتا');
    }
    return response.json();
  })
  .catch(error => console.error(error));

نتیجه‌گیری

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

با تشکر از خوندنت! 😊 اگر دوست داشتی بیشتر یاد بگیری، منتظر مقاله بعدی "کار با API های امن و توکن‌دار" باش!