API چیست؟ راهنمای جامع برای مبتدیان و مینی درس

بنابراین می خواهید یک وب سایت دستور العمل کوکتل ایجاد کنید. آیا انتظار دارید کاربران شما در نوشیدنی ها با نام یا ماده تشکیل دهنده جستجو کنند و بر اساس آنچه انتخاب می کنند چندین دستور العمل دریافت کنند؟

چگونه این کار را بدون نوشتن صدها دستور العمل کوکتل و ساختار داده ها در یک پایگاه داده و ایجاد تمام منطق دسترسی به داده ها ایجاد کنیم؟

پاسخ استفاده از API است. همانطور که شخصی قبلاً داده ها را برای استفاده ایجاد کرده است.

ما به این مثال باز خواهیم گشت تا ببینیم این پروژه با استفاده از API و Postman برای درخواست API چقدر می تواند آسان باشد.

API: مقدمه ای برای مبتدیان

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

API چیست؟

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

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

همچنین API های داخلی وجود دارد که شما برای ساختن یک برنامه iOS استفاده می کنید. به عنوان مثال ، اپل یک API را برای زمانی ارائه می دهد که به شما امکان می دهد زمان کاربر محلی را در برنامه خود نشان دهید.

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

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

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

تاریخ API

اولین API در روزهای اول اینترنت به عنوان راهی برای دسترسی به اطلاعات از سرورهای وب ایجاد شد. این API های اولیه ساده و محدود بودند ، اما آنها پایه و اساس API های پیچیده تری را که امروزه از آنها استفاده می کنیم ، گذاشتند.

با توسعه اینترنت ، API توسعه یافت. امروزه ، API توسط توسعه دهندگان برای دسترسی به داده ها و عملکرد از کلیه خدمات آنلاین استفاده می شود. به عنوان مثال API توییتر به توسعه دهندگان اجازه می دهد تا برنامه هایی را که در توییتر به عنوان تعدادی از دنبال کننده ها وجود دارد ، بسازند. و API اینستاگرام REELS به توسعه دهندگان اجازه می دهد تا برنامه هایی را بسازند که به کاربران خود اجازه می دهد فیلم های IG Reel را در اینستاگرام ایجاد کنند. اینها فقط بخشی از API رسانه های اجتماعی است.

API ها به بخش مهمی از اینترنت تبدیل شده اند و آنها همچنان در سالهای آینده نقش اساسی را بازی می کنند.

چگونه API کار می کند؟

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

API بخش مهمی از توسعه نرم افزار است زیرا به توسعه دهندگان اجازه می دهد تا از کد و مؤلفه هایی که قبلاً ایجاد شده اند استفاده مجدد کنند. این می تواند باعث صرفه جویی در وقت و تلاش زیادی شود و همچنین سطح بالاتری از کیفیت و قوام را فراهم کند.

درک API بدون نوشتن کد

اگر شما یک توسعه دهنده نرم افزار هستید ، احتمالاً قبلاً با API آشنا هستید. با این حال ، اگر رمزگذاری نکنید ، اغلب دیدن نمونه ای از API در زندگی واقعی مفید است تا آن را ملموس تر کند و مطمئن شوید که می فهمید. ما از API REST استفاده خواهیم کرد که امروزه رایج ترین شکل API است.

ابزاری عالی که می توانید برای آزمایش و درک API از آن استفاده کنید ، پستاندار است. به postman.com بروید و یک حساب رایگان تنظیم کنید و برنامه را بارگیری کنید یا نسخه وب را امتحان کنید. بیایید یک مثال ساده را با هم طی کنیم.

با اولین API خود تماس بگیرید

به TheCocktailDb.com مراجعه کنید. می توانید یک نام نوشیدنی وارد کنید و مواد و دستورالعمل های مربوط به نحوه تهیه یک کوکتل را دریافت کنید. این یک بانک اطلاعاتی عالی است که از طریق API در دسترس است ، که گاهی اوقات به آن API وب خوانده می شود.

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

www.thecocktaildb.com/api/json/v1/1/search.php?s=margarita

قسمت اول URL به “PHP” نقطه پایان API است. مهم نیست که کدام کوکتل را می خواهید به دنبال آن باشید. هر بار که می خواهید به دنبال یک کوکتل باشید ، این نقطه پایانی است که از آن استفاده می کنید.

قسمت دوم URL “S = Margarita” است. حرف “S” نشان می دهد که شما می خواهید پس از “S” جستجو و ارزش را انجام دهید ، نام نوشیدنی است. در این مثال ، نوشیدنی که به دنبال آن هستید مارگاریتا است. این جفت پارامترهای درخواست (“S” و “Margarita”) به یک جفت کلید گفته می شود و بعد از “؟” ذکر شده است؟

بیایید اکنون یک پستچی باز کنیم. ابتدا یک فضای کاری جدید و سپس یک مجموعه جدید در این فضای کاری ایجاد کنید. من فضای کار خود را “API رایگان” و مجموعه “API رایگان” خود خواندم. می توانید هر نامی را که می خواهید به آنها بدهید.

صفحه ای شبیه به این صفحه را مشاهده خواهید کرد. یک اتصال آبی برای “اضافه کردن یک درخواست” وجود دارد. روی این کلیک کنید و بیایید با یک API واقعی ارتباط برقرار کنیم.

URL را از CocktailDB در کادر “Enter the URL” کپی کرده و وارد کنید و پستچی این موضوع را به عنوان یک تماس API تشخیص می دهد.

می توانید در بخش Params مشاهده کنید که Postman یک کلید “S” و مقدار “مارگاریتا” را برای این کلید اضافه می کند. می توانید مقدار را وارد کنید و اتصال فوق به روز می شود.

بیایید ارزش مارتینی را تغییر دهیم و هرچه وارد می شویم ، می توانیم ببینیم که پستچی همچنین URL را به روز می کند.

اکنون دکمه “ارسال” را فشار دهید. در یک ثانیه مجموعه ای از داده ها را برای پر کردن پنل پایین مشاهده خواهید کرد. این تاریخ به عنوان JSON ساختار یافته است ، که خواندن آن برای ما آسان است. می توانید دستورالعمل ها ، مواد تشکیل دهنده و اطلاعات بیشتری را که می توانید در وب سایت جدید خود نشان دهید مشاهده کنید.

تبریک می گویم! شما فقط تماس API خود را برقرار کرده اید و داده ها را از یک سرور از راه دور دریافت کرده اید. می توانید نام نوشیدنی را تغییر داده و برای به دست آوردن داده های لازم بیشتر تماس بگیرید.

پایان

در این مقاله برخی از تئوری های پشت API را آموخته اید ، و همچنین تماس های API خود را با استفاده از پستچی انجام داده اید تا نحوه دریافت داده ها را از یک سرور از راه دور دریافت کنید.

با ادامه سفر خود ، جستجوی API همیشه مفید است که می تواند کار شما را آسان تر کند یا وقت شما را برای راه اندازی محصول خود بهبود بخشد.