API چیست

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

امروزه ما اکثر زمان ها از اصطلاح API به کارگیری میکنیم.
اشخاص متعددی می‌باشند که چه در قضیه فناوری و چه در جاهای دیگر ، تصوری غیر قابل فهم یا این که غلط در زمینه ی معنای این اصطلاح نسبتاً رایج دارا‌هستند.
یک Application Programming Interface (API) (رابط اپلیکیشن نویسی کاربردی) گروه خاصی از ضوابط (“کد”) و مشخصاتی میباشد که نرم‌افزار ها می‌توانند برای برقراری رابطه با یکدیگر از آن‌ها تاسی نمایند.
API ها سالانه به صورت تصاعدی در هم اکنون رویش می باشند.

دنیای برنامه به‌سرعت در هم اکنون تکان میباشد.
تا قبل از این اطلاعات در یک سیستم وارد و پردازش می شدند ، البته در حال حاضر مبدا اطلاعات و جای پردازش به طور کاملً مختلف میباشد.
ما بایستی بتوانیم از هر کجا و در هر فرصت به اطلاعات دسترسی داشته باشیم ، به همین ادله میباشد که‌این اطلاعات را در فضای ذخیره سازی ابری ذخیره می‌کنیم.

برای ارسال و اخذ اطلاعات از سرور، ما یک واسطه می‌خواهیم که جداگانه از پلتفرم باشد.
این واسطه درخواست ها را مطالعه می نماید و به استفاده کننده جواب می‌دهد. (آری صحیح در نظر گرفتن زدید این واسطه به عبارتی api میباشد.)

مخاطب آخری یک درخواست ارسال می نماید ، API آیین نامه را انجام می نماید و آنگاه اطلاعات را از سرور اخذ می نماید و به مخاطب جواب میدهد.

اتصال به اینترنت سرور و تعامل با Rest API
خب در قسمت اولیه نوشته‌ی‌علمی ی خویش میخواهیم به شما فراگیری دهیم که به چه شکل از کلاس ها و طریق های مو جود در Android SDK برای اتصال به اینترنت سرورهای راه و روش بدور و تعامل با آنان با به کارگیری از REST API آن‌ها به کار گیری نمایید.

۱- فعال کردن دسترسی به وب
به کار گیری از REST API هویدا میباشد که نیازمند به کارگیری از وب میباشد.
با این اکنون ، اپ های Android فقط در حالتی که میتوانند به وب دسترسی داشته باشند که دارنده جواز android.permission.INTERNET باشند.
براین اساس ، پیش از استارت تایپ کردن هر کد کانال ای ، بایستی مطمئن گردید که تگ use-permission تحت در پوشه manifest پروژه شما وجود داراست :


از آنجایی که android.permission.INTERNET تایید صلاحیت خطرناکی در حیث گرفته نمی‌شود ، مایحتاج وجود ندارد در طی فرصت اعمال در دستگاه هایی که API سطح 23 یا این که فراتر دارا‌هستند، آن را درخواست فرمایید.

۲- تولید Background Threads
پلتفرم اندروید به شما اذن نمی دهد که عملیات کانال را روی فن اساسی (main thread) نرم‌افزار اعمال فرمایید.
بدین ترتیب ، مجموع کدهای کانال شما بایستی به یک فن دور نما (background thread) وابستگی داشته باشد.
یک تحت کلاس AsyncTask شیوه های ذیل را برای اعمال فعالیت فارغ حرفه اساسی داراست :

() onPreExecute : این اسلوب روی UI thread ایفا می گردد و برای تهیه و تنظیم تسک شما (مانند اکران نوار توسعه و گسترش) به کار گیری می‌گردد.
() doInBackground : این جایی میباشد که شما کدی را برای اجرای کاری که قرار میباشد روی فن غیر وابسته صورت پذیرد، طراحی می‌کنید.
() onProgressUpdate : این در UI thread فراخوانی میشود و برای آپدیت رسانی توسعه در UI (مانند لبریز کردن نوار بسط) به کار گیری میشود.
() onPostExecute : مجدد در UI thread ، این برای آپ تو دیت رسانی نتیجه ها به UI بعد از اتمام بارگیری AsyncTask استعمال می‌شود.
private class MyTask extends AsyncTask {


// All your networking logic
// should be here


}
۳- ایجاد کرد یک HTTP Connection
با استعمال از () openConnection متدی از کلاس URL ، می‌توانید با‌گاز یک اتصال به جای‌جای نهایی REST فعال سازی نمایید.
مقدار بازگشتی () openConnection می بایست به مثال‌ای از HttpURLConnection یا این که HttpsURLConnection نبی گردد، بسته به اینکه آیا نقطه نهایی از روش HTTP یا این که HTTPS قابل دسترسی میباشد.
هر دو HttpURLConnection و HttpsURLConnection به شما قابلیت و امکان می‌دهند عملیات هایی مانند افزودن request headers و reading responses را ایفا دهید.

قطعه کد ذیل به شما آرم می‌دهد که چه گونه یک اتصال را با GitHub API’s root endpoint تهیه و تنظیم نمائید