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

API مخفف واژگان Application Programming Interface به معنی «رابط های برنامه نویسی اپلیکیشن» می باشد. به طور خلاصه، ای پی آی به راحتی این امکان را در اختیار یک برنامه نویس می‌دهد تا به‌ برخی یا تمامی قابلیت‌های یک نرم‌افزار دیگر دسترسی پیدا کند. به طور مثال، فرض کنیم نرم‌افزاری تحت عنوان الف وجود دارد که شرکت توسعه‌دهنده اش، این امکان را برای سایر توسعه دهندگان فراهم آورده تا از API آن استفاده کنند. نرم افزاری را هم که توسعه می‌دهیم نرم‌افزار ب نام دارد. حال نرم‌افزار الف در چارچوب خاصی به نرم‌افزار ب اجازه می‌دهد تا از اطلاعات آن استفاده کند. در استفاده از API می بایست موارد زیر را حتماً مد نظر قرار داد:

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

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

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

– APIها دارای یک API Key هستند. برای آن که به راحتی مشخص شود که Request یا «درخواست» از طرف چه سایت یا نرم افزاری است، ای پی آی ها یکی API Key یا «شناسه ی ای پی آی» در اختیار توسعه دهندگان قرار می‌دهند که در هر درخواست، این شناسه هم برای شرکت الف ارسال می‌شود که آن طریق، ماهیت اپلیکیشن شما برای آن سیستم مشخص شده و بر اساس توافقاتی که برای استفاده از ای پی آی صورت گرفته، خدمات را در اختیار شما قرار می دهد. علاوه بر این، شناسه ای که در اختیار شما -به عنوان یک توسعه‌دهنده- قرار می گیرد، مشخص می‌کند که شما هر چند وقت یک بار خواهید توانست برای نرم‌افزار الف درخواست ارسال کنید. به طور مثال، این API ممکن است که صرفاً در بازه های زمانی نیم ساعته به درخواست ها پاسخ گوید و در صورتی که اپلیکیشنی هر ده دقیقه یک بار، یک درخواست ارسال کند، API Key مشخص کننده ارسال کننده ی درخواست بوده و درخواست شما اصطلاحاً Ignore شده یا «نادیده» گرفته می شود.

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

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

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

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

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

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

اعتماد کردن به مشتریان و ارائه ی امکاناتی بیش از آنچه که یک محصول ساده به دست می دهد، می تواند در میان مشتریان یک حس اعتماد و وفاداری عمیق ایجاد کند. این موضوع می تواند برگ برنده ی شما در مقایسه با رقبا باشد.

APIها همانند مبحث «سرویس های ابری» می مانند؛ خیلی ها صرفاً برای آن که به روز باشند از آن استفاده می کنند، بدون آن که کاربرد صحیح آن را بدانند. اما آیا شما نیز باید این کار را بکنید؟ آیا نیازی به استفاده از آن هست؟ توجه داشته باشید که طراحی و مدیریت APIها نیازمند نیروی انسانی متخصص و منابع بیشتر است. آیا در حال حاضر این موارد را در اختیار دارید؟

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

برای حل این قبیل مشکلات چندین راه حل وجود دارد: دسترسی به API را توسط یک سیستم شناسایی کاربر قدرتمند حفاظت کنید، حتی اگر آن API را به رایگان ارائه می کنید. سعی کنید سرویس API خود را بر روی سروری جداگانه و متفاوت از دیتابیسی که به آن متصل می شود، راه اندازی کنید. اگر به کاربران خود امکان اضافه کردن و یا ویرایش اطلاعات را نیز می دهید، خود را برای مقابله با حملات Injection آماده کنید. یکی دیگر از حملات سایبری خطرناک Denial of Service یا DOS نام دارد که نیاز دارید تا راهکارهای حفاظتی برای مقابله با این حملات را نیز رعایت کنید.

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

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

API مخفف application programming interface (رابط برنامه‌نویسی نرم‌افزار) واسطه‌ای است بین یک کتابخانه با برنامه‌هایی که از آن کتابخانه تقاضای سرویس می‌کنند.
به صورت ساده و قابل فهم، API ها مثل function هایی هستند که در یک سرور (یا سیستم عامل) وجود دارد و یک برنامه نویس در برنامه خود می‌تواند آنها را فراخوانی و استفاده کند بدون اینکه به سورس و نحوه عملکرد آن دسترسی داشته باشد.
به عنوان مثال ویندوز یک سیستم عامل کدبسته (غیر اپن سورس) است اما مایکروسافت برای ویندوز، APIهایی قرار داده است که با استفاده از آنها، برنامه‌نویسان می‌توانند از قابلیت‌ها و سرویس‌های سیستم‌عامل ویندوز در توسعه و نوشتن برنامه‌های کاربردی خود استفاده کنند.

API های تحت وب

API های تحت وب به مراتب گسترده‌تر، پرکاربردتر و از همه مهم‌تر؛ مستقل از سیستم‌عامل است. یعنی یک برنامه ممکن است روی سیستم عامل لینوکس باشد اما شما که یک سرور ویندوزی دارید، می‌توانید از API آن به سادگی استفاده کنید.
SOAP و REST دو گروه معروف از API های تحت وب هستند که دومی ساده‌تر و استفاده از آن آسان‌تر است. اگر شما کتاب RESTful Web APIs را که تازه چاپ شده، دانلود و مطالعه بفرمایید، بیشتر با آن آشنا می‌شوید.

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

معرفی چند نمونه API

یکی از جذاب‌ترین API های معرفی شده در این لیست برای من API مربوط به تبدیل فایل بود که به کمک آن می‌توانید هر نوع فایل (صوتی/تصویری/متنی/…) را به نوع دیگر تبدیل کنید!
مثلا می‌توانید یک فایل wma یا wav را به mp3 تبدیل کنید یا یک فیلم avi را به mp4
یا می‌توانید یک فایل word تحویل بدهید و یک فایل txt تحویل بگیرید و …
آپدیت: امروز سایت Encoding.com را دیدم که در پلن رایگان خود نیز امکانات خوبی برای تبدیل فایل‌های صوتی و تصویری به صورت آنلاین توسط صفحه وب و همچنین API فراهم آورده است که برای سایت‌های حاوی صوت و تصویر عالی است.

در این صفحه گیت‌هاب نیز لیست خوبی فراهم آمده است.

API های سرویس آپلود فایل: به شخصه از این API ها زیاد استفاده کرده‌ام. خصوصا برای تهیه بکاپ اتوماتیک آنلاین.
بسیاری از سرویس‌های اشتراک فایل یا آپلودسنترهای معتبر، دارای یک رابط برنامه نویسی API برای developer ها هستند که به برنامه نویس امکان می‌دهد به سادگی فایل‌های موردنظرش را در آن سرویس آپلود کند. از جمله آنها می‌توان به filecloud.io و ge.tt و … اشاره کرد.
ناگفته نماند که برخی از اینگونه سایت‌ها، امکان آپلود از طریق ftp را نیز در اختیار کاربر قرار می‌دهند که کار را بسیار ساده‌تر می‌کند .از جمله این سایت‌ها نیز می‌توان uploading.com و archive.org را نام برد.

API برای OCR: که البته بیشتر برای دور زدن کپچاهای ساده کاربرد دارد تا تبدیل متن اسکن شده به متن تایپ‌شده 🙂
این یک نمونه سرویس رایگان (اما محدود به 5 هزار در ماه) برای OCR است که API هم دارد و این هم یک نمونه کدبرای کار با آن است. این سرویس نیز هرچند رایگان نیست اما قیمت آن تقریبا معادل رایگان است!

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

طبعا API برای برنامه‌نویسان تهیه شده و برای استفاده از آن لازم است در دانش برنامه‌نویسی اطلاعاتی داشته باشید. بسیاری از سایت‌هایی که دارای API هستند، به همراه آن مثال و نمونه‌کد آموزشی نیز ارائه می‌دهند.
در این مطلب نیز بیش از 16 مقاله در مورد استفاده از چند API ی معروف لیست شده است.

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

ممکن است شما برای کارتان به یک API نیاز داشته باشید. اولین راهی که برای یافتن API کارآمد به ذهن هر کس می‌رسد، جستجو در گوگل یا پرسش در Stackoverflow است. اما علاوه بر آن، شما می‌توانید از سایت‌هایی همچون Mashape و ProgrammableWeb نیز در این جهت استفاده کنید که انواع API های مختلف را لیست کرده‌اند…

چگونه برای سایت خود API بنویسم؟

ممکن است فکر کنید که نوشتن یک API برای یک سایت سخت است اما اینطور نیست. نوشتن API آسان‌تر از نوشتن برنامه کامل یک سایت است زیرا در API صرفا قرار است حسب آدرس درخواستی، داده‌ها (اطلاعات) با ساختاری که از قبل تعیین کردید (مثلا JSON) به عنوان پاسخ آورده شود.

همچنین همانطور که بخشی از یک سایت می‌تواند فقط مختص کاربران احراز هویت شده باشد، در API هم می‌تواند همه یا بخشی از آن مختص کاربرانی باشد که احراز هویت شده‌اند. البته یک نکته ظریف وجود دارد و آن اینکه در API نمی‌توان کپچا گذاشت چون API ها توسط برنامه‌ها (و نه انسان) استفاده می‌شود. لذا API های متداول، به جای user, password از یک کلید رندوم مثلا 50 کاراکتری به نام API key استفاده می‌کنند که تشخیص آن عملا غیرممکن است (برخلاف پسوردها که معمولا کوتاه است و با حمله brute force می‌توان آن را حدس زد). ضمن اینکه در این روش، پسورد کاربر محفوظ می‌ماند و همچنین با API key های مختلف، می‌توان نظارت و کنترل بهتری روی برنامه استفاده‌کننده از API سایت‌مان داشته باشیم و در صورت نیاز موارد مشکوک یا پرمصرف را مسدود یا غیررایگان کنیم.

اگر هنوز در برنامه‌نویسی PHP چندان مسلط نیستید، کتابخانه‌های PHP وجود دارد که برای شروع API نویسی، نمونه خوبی هستند مثلا این فریم‌ورک مخصوص API از آقای martin bean را ببینید.

نوشته API چیست؟ اولین بار در راهکارهای جامع دیتاسنتر. پدیدار شد.

نوشته برطرف کردن مشکل دسترسی نرم افزارها در Domain User اولین بار در راهکارهای جامع دیتاسنتر. پدیدار شد.