هرآنچه که باید درباره API بدانید

بیشتر API ها به  طراحی اپلیکیشن   یک API-key نیاز دارا‌هستند. یعنی هروقت یک API پیدا کردید و خواستید از آن به کارگیری نمائید، می بایست در آغاز Documentation آن را مطالعه فرمایید تا ملاحظه کنید برای وصل شدن به آن به چه چیزهایی نیاز دارید. بخش اعظمی از آن‌ها از شما می خواهند نام‌و‌نشان خودتان را تایید نمائید، از جمله با آمدن با حساب گوگل می توانید این فعالیت را انجام بدهید. سپس یک کد منحصر به شما داده میگردد و بعد از آن با به کارگیری از آن می‌توانید به API متصل بشوید. یعنی دیگر موردنیاز وجود ندارد هربار برای متصل شدن، نشانی اینترنتی و پسورد خودتان را وارد نمائید (که زیاد هم ایمن وجود ندارد و نباید خیلی به آن اعتماد داشته باشید. در رابطه طرز های تایید نام‌و‌نشان به زودی توضیحاتی در تارنما ارائه میدیم).
ریلکس ترین خط مش برای دسترسی به API کشف کردن یک کلاینت HTTP آنلاین میباشد، مانند REST-Client، Postman یا این که Pow که می توانید با کاوش کردن از آن ها به کار گیری فرمائید. این ابزار های از پیش تشکیل‌شده (که عموما بدون‌پول هم می‌باشند)، به شما امداد میکنند که برای دسترسی به API ها بتوانید درخواست های خودتان را بسازید و می بایست از کد مخصوص به شخصی که به شما داده شده‌است (یا این که به عبارتی API-Key) به کار گیری فرمایید. هنوز هم نیاز دارید که با سینتکس آن ها از روش Documentation به کار گیری نمائید، ولی علم کدنویسی متعددی نیاز نخواهید داشت.
یک کدام از خط مش های مبنا ای برای استخراج داده ها از یک API، ساختن یک URL (ایمیل) از روی داکیومنتیشن آن میباشد. این ویدئوی آموزشی به شما نشان می دهد که چه‌طور داده ها یک جای جغرافیایی را از API گوگل مپ اخذ فرمایید و از آن خصوصیات به کارگیری نمایید تا عکس های مجاورت آن حوزه‌ را در اینستاگرام پیدا فرمائید.
در مجموع، یک درخواست که برای API فرستاده می شود، زیاد تفاوتی با URL هایی که در مرورگر مینویسیم یا این که می‌بینیم ندارد، ولی فرمتی که برگردانده می شود چیزی میباشد که قرائت آن‌ها بیشتر برای کامپیوتر ها شل میباشد. مثلا این اتفاقی میباشد که صورت می دهد، زمانی اینجانب داده هایی را از API یک تارنما ارائه دهنده داده ها هواشناسی درخواست می‌کنم. دقت داشته باشید که‌این درخواست را از روش مرورگر ارسال کرده ام.

ساختن یک URL از روی Documentation: داده ها هواشناسی را برای یک شهر خاص اخذ می‌کنیم. این چنین:

api.openweathermap.org/data/2.5/weather?q={city name}
نوشتن در مرورگر اینترنتی: این نشانی را در مرورگر وب خودتان تایپ فرمایید:

api.openweathermap.org/data/2.5/weather?q=Nashville,TN&APIID={numberslettersnumbersletters}
می‌توانید فیض را در عکس تحت ببینید. (اما بایستی API-Key خودتون رو آخرش فی مابین دو عدد آکولاد وارد نمائید).

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

درین نوشته‌علمی تنها مورد ها مبنا ای و سطحی در امر تکنولوژی API را توضیح دادیم. اینجانب برای یادگیری بیشتر در وب جستجوهایی کردم و مقالات و ویدئوهایی را پیدا کردم که پیوند آن ها را برای شما هم در‌این بخش قرار می ‌دهم تا داده ها بیشتری به دست بیاورید:

API چه است؟
فناوری RESTful API چه است و چه طور فعالیت می‌نماید؟
Using APIs: Not Quite as Hard as it Looks
Web APIs for non-programmers
An Introduction to APIs
What APIs Are And Why They’re Important
در حالتی‌که شما هم منبع خیر را می‌شناسید یا این که اطلاعاتی در این مورد دارید، می توانید با تایپ کردن آن ها در بخش ایده ها (همین ذیل) ما‌را در جامع تر کردن این نوشته‌ی علمی آموزشی امداد فرمایید. معطل تجربه ها و ایده ها شما دوستان عزیز هستیم