شما در حال مشاهده اسناد Apigee Edge هستید.
به مستندات Apigee X بروید . اطلاعات
Apigee Edge پلتفرمی برای توسعه و مدیریت APIها است. Edge با ارائه خدمات با یک لایه پروکسی، یک انتزاع یا نمای برای APIهای سرویس باطن شما فراهم می کند و امنیت، محدودیت نرخ، سهمیه، تجزیه و تحلیل و موارد دیگر را فراهم می کند.
برای مثال، میتوانید یک پخش اینترنتی در مورد نحوه استفاده Walgreens از APIها و Apigee Edge برای ارائه یک اکوسیستم برنامه غنی در مورد چاپ عکس، نسخهها و سایر خدماتی که ارائه میکنند، مشاهده کنید .
شتاب دیجیتال
این ویدیو به شما یک نمای سریع از اینکه چگونه Apigee به شما کمک می کند تا به یک تجارت دیجیتالی تبدیل شوید، می دهد.
انتخاب بین مدیریت سرویس و مدیریت API
این ویدیو به شما کمک می کند تا تفاوت های مهم بین مدیریت سرویس و مدیریت API را درک کنید. کسب و کار
در دسترس قرار دادن خدمات خود در وب
امروزه شرکتها میخواهند خدمات پشتیبان خود را در وب در دسترس قرار دهند تا این خدمات توسط برنامههایی که روی دستگاههای تلفن همراه و دسکتاپ اجرا میشوند، مصرف شوند. ممکن است یک شرکت بخواهد خدماتی را ارائه دهد که اطلاعات مربوط به قیمت و در دسترس بودن محصول، خدمات فروش و سفارش، خدمات ردیابی سفارش و سایر خدمات مورد نیاز برنامه های مشتری را ارائه می دهد.
شرکت ها اغلب خدمات را به عنوان مجموعه ای از نقاط پایانی HTTP در معرض نمایش می گذارند. سپس توسعه دهندگان برنامه های مشتری درخواست های HTTP را به این نقاط پایانی می دهند. بسته به نقطه پایانی، سرویس ممکن است دادههای فرمتشده به صورت XML یا JSON را به برنامه مشتری بازگرداند.
برنامههای سرویس گیرندهای که این خدمات را مصرف میکنند میتوانند بهعنوان برنامههای مستقل برای یک دستگاه تلفن همراه یا رایانه لوحی، بهعنوان برنامههای HTML5 که در مرورگر اجرا میشوند، یا بهعنوان هر نوع برنامه دیگری که میتواند به یک نقطه پایانی HTTP درخواست بدهد و دادههای پاسخ را مصرف کند، پیادهسازی شود. این برنامهها ممکن است توسط همان شرکتی که این سرویسها را افشا کرده است، یا توسعهدهندگان برنامههای شخص ثالثی که از سرویسهای در دسترس عموم استفاده میکنند، توسعه و منتشر کنند.
تصویر زیر این نوع مدل را نشان می دهد:
از آنجا که ارائه دهندگان خدمات خود را از طریق وب در دسترس قرار می دهند، باید اطمینان حاصل کنند که تمام اقدامات لازم را برای ایمن سازی و محافظت از خدمات خود در برابر دسترسی غیرمجاز انجام داده اند. به عنوان یک ارائه دهنده خدمات، موارد زیر را در نظر بگیرید:
- امنیت: چگونه دسترسی به خدمات خود را برای جلوگیری از دسترسی غیرمجاز کنترل خواهید کرد؟
- سازگاری: آیا سرویس های شما در پلتفرم ها و دستگاه های مختلف کار خواهند کرد؟
- قابلیت اندازه گیری: چگونه می توانید خدمات خود را برای اطمینان از در دسترس بودن آنها نظارت کنید؟
- کسب درآمد: چگونه می توانید مشتریان را برای دسترسی به خدمات خود ردیابی و صورتحساب بگیرید؟
- و بسیاری ملاحظات دیگر
پس از انتشار یک برنامه مشتری که به هر سرویسی دسترسی داشت، ارائهدهنده خدمات موظف است مطمئن شود که آن سرویسها در طول زمان و با افزودن، اصلاح یا حذف آن سرویسها به کار خود ادامه میدهند. ارائهدهنده خدمات همچنین باید راهی برای آگاه ساختن توسعهدهندگان برنامه از هرگونه تغییر در سرویسها داشته باشد تا اطمینان حاصل شود که برنامههای مشتری با آن سرویسها همگام میشوند.
توسعه دهندگان برنامه های مشتری هنگام تلاش برای استفاده از خدمات ارائه دهندگان مختلف با چالش هایی مواجه می شوند. امروزه فناوریهای زیادی برای استفاده توسط یک ارائهدهنده خدمات برای نمایش خدماتش در دسترس است. ممکن است همان برنامه مشتری مجبور باشد از یک مکانیسم برای مصرف یک سرویس از یک ارائه دهنده، و مکانیسم متفاوتی برای مصرف سرویس از یک ارائه دهنده متفاوت استفاده کند. توسعه دهندگان برنامه حتی می توانند با شرایطی روبرو شوند که مجبور شوند از مکانیسم های مختلفی برای مصرف خدمات از یک ارائه دهنده استفاده کنند.
خدمات را از طریق Apigee Edge در دسترس قرار دهید
Apigee Edge شما را قادر می سازد تا دسترسی ایمن به خدمات خود را با یک API کاملاً تعریف شده ارائه دهید که در همه سرویس های شما بدون توجه به اجرای سرویس سازگار است. یک API سازگار:
- استفاده از خدمات شما را برای توسعه دهندگان برنامه آسان می کند.
- شما را قادر می سازد تا اجرای سرویس Backend را بدون تأثیر بر API عمومی تغییر دهید.
- به شما امکان می دهد از تجزیه و تحلیل، کسب درآمد، پورتال توسعه دهنده و سایر ویژگی های ساخته شده در Edge استفاده کنید.
تصویر زیر یک معماری را نشان میدهد که Edge درخواستهای برنامههای مشتری به خدمات باطن شما را مدیریت میکند:
به جای اینکه توسعه دهندگان برنامه مستقیماً خدمات شما را مصرف کنند، به یک پروکسی API ایجاد شده در Edge دسترسی دارند. پروکسی API به عنوان نگاشت یک نقطه پایانی HTTP در دسترس عموم به سرویس باطن شما عمل می کند. با ایجاد یک پروکسی API به Edge اجازه میدهید تا وظایف امنیتی و مجوز لازم برای محافظت از سرویسهای شما و همچنین تجزیه و تحلیل، نظارت و کسب درآمد از آن سرویسها را انجام دهد.
از آنجایی که توسعهدهندگان برنامه درخواستهای HTTP را بهجای مستقیماً به سرویسهای شما، به یک پراکسی API ارسال میکنند، توسعهدهندگان نیازی به دانستن چیزی در مورد اجرای سرویسهای شما ندارند. تنها چیزی که توسعه دهنده باید بداند این است:
- URL نقطه پایانی پروکسی API.
- هر پارامتر پرس و جو، سرصفحه یا پارامتر بدنه که در یک درخواست ارسال می شود.
- هر گونه احراز هویت و اعتبار مورد نیاز.
- قالب پاسخ، از جمله قالب داده پاسخ، مانند XML یا JSON.
پروکسی API توسعهدهنده برنامه را از سرویس باطن شما جدا میکند. بنابراین، تا زمانی که API عمومی ثابت بماند، میتوانید اجرای سرویس را تغییر دهید. با حفظ یک API یک frontend ثابت، برنامه های مشتری موجود بدون توجه به تغییرات در backend به کار خود ادامه می دهند.
میتوانید از خطمشیهای روی پراکسی API برای افزودن عملکرد به یک سرویس بدون نیاز به ایجاد هیچ تغییری در سرویس باطن استفاده کنید. به عنوان مثال، میتوانید برای انجام تبدیل دادهها و فیلتر کردن، افزودن امنیت، اجرای منطق شرطی یا کد سفارشی و انجام بسیاری از اقدامات دیگر، سیاستهایی را به پروکسی خود اضافه کنید. نکته مهمی که باید به خاطر بسپارید این است که سیاستها را روی Edge پیادهسازی میکنید، نه در سرور باطن خود.
برای اطلاعات بیشتر، به درک API ها و پراکسی های API مراجعه کنید.
یک محصول API ایجاد کنید
یک پروکسی API نقطه پایانی HTTP در Apigee Edge است که توسعه دهندگان برای دسترسی به خدمات باطن شما از آن استفاده می کنند. در حالی که این امکان وجود دارد، شما معمولاً پراکسی های API فردی را در دسترس قرار نمی دهید. در عوض، یک یا چند پروکسی API را در یک محصول API گروه بندی می کنید.
یک محصول API مجموعه ای از پراکسی های API است که با یک طرح خدمات ترکیب شده است. این طرح خدمات میتواند محدودیتهای دسترسی را برای پراکسیهای API تعیین کند، امنیت را فراهم کند، امکان نظارت و تجزیه و تحلیل را فراهم کند و ویژگیهای اضافی را ارائه دهد. محصولات API همچنین مکانیزم مرکزی هستند که Edge برای مجوز و کنترل دسترسی به API های شما استفاده می کند.
هنگام ایجاد محصولات API انعطاف پذیری زیادی دارید. به عنوان مثال، چندین محصول API می توانند یک پروکسی API را به اشتراک بگذارند. شکل زیر سه محصول API را نشان می دهد. توجه داشته باشید که همه محصولات اجازه دسترسی به API Proxy 3 را می دهند، اما فقط محصول A اجازه دسترسی به API Proxy 1 را می دهد.
میتوانید ویژگیهای مختلفی را روی هر محصول API تنظیم کنید. برای مثال، ممکن است یک محصول API را با محدودیت دسترسی کم، مانند 1000 درخواست در روز، با قیمت مقرون به صرفه در دسترس قرار دهید. سپس محصول API دیگری را منتشر می کنید که دسترسی به همان پراکسی API را فراهم می کند، اما با محدودیت دسترسی بسیار بالاتر، با قیمت بالاتر. یا، ممکن است یک محصول API رایگان ایجاد کنید که امکان دسترسی فقط خواندنی به خدمات شما را فراهم کند، و سپس یک محصول API را به همان پراکسیهای API که امکان دسترسی خواندن/نوشتن را میدهد، بفروشید.
برای اطلاعات بیشتر، به مدیریت محصولات API مراجعه کنید.
به یک برنامه سمت سرویس گیرنده اجازه دهید به محصول API شما دسترسی داشته باشد
وقتی توسعه دهندگان برنامه تصمیم می گیرند که می خواهند به خدمات شما دسترسی داشته باشند، ابتدا باید برنامه مشتری خود را با محصول API شما ثبت کنند.
پس از ثبت نام، یک توسعهدهنده برنامه یک کلید API دریافت میکند که باید آن را در هر درخواست به یک پروکسی API موجود در محصول API اضافه کند. آن کلید احراز هویت شده است و در صورت موفقیت آمیز بودن احراز هویت، به درخواست اجازه داده می شود تا به سرویس پشتیبان شما دسترسی پیدا کند.
در هر زمان میتوانید کلید را لغو کنید تا برنامه مشتری دیگر به خدمات شما دسترسی نداشته باشد. یا میتوانید برای یک کلید محدودیت زمانی تعیین کنید تا توسعهدهنده باید کلید را پس از یک زمان خاص تازهسازی کند.
شما تصمیم می گیرید که چگونه به درخواست های ثبت نام از سوی توسعه دهندگان برای دسترسی به محصولات API خود رسیدگی کنید. با استفاده از خدمات توسعه دهنده Apigee Edge، می توانید فرآیند ثبت نام را خودکار کنید. یا می توانید از یک فرآیند دستی برای کنترل دسترسی استفاده کنید.
محصولات API را ایجاد کنید و آنها را در دسترس توسعه دهندگان قرار دهید
- یک یا چند پروکسی API ایجاد کنید که نشانیهای وب در دسترس عموم را به خدمات باطن شما نگاشت میکنند.
- یک محصول API ایجاد کنید که پراکسیهای API شما را جمع کند.
- پروکسی های API و محصول API خود را مستقر کنید.
- به توسعه دهندگان خود اطلاع دهید که محصول API در دسترس است.
هنگامی که توسعه دهندگان برنامه از در دسترس بودن محصول API شما مطلع شوند، آنها:
- برنامه های مشتری آنها را با محصول API خود ثبت کنید.
- یک کلید API برای محصول API دریافت کنید.
- از طریق پراکسیهای API (که در محصول API قرار دارند) درخواستها را به خدمات خود ارسال کنید و با هر درخواست کلید API را ارسال کنید.
اجزای Apigee Edge
Apigee Edge متشکل از زمان اجرا، نظارت و تجزیه و تحلیل API و خدمات توسعه دهنده است که در کنار هم زیرساخت جامعی را برای ایجاد، امنیت، مدیریت و عملیات API فراهم می کنند.
شکل زیر خدمات Edge را نشان می دهد:
زمان اجرا Edge API
خدمات Apigee Edge API همه چیز در مورد ایجاد و مصرف API است، چه در حال ساخت پروکسی API به عنوان یک ارائه دهنده خدمات باشید و چه از API، SDK، و سایر سرویس های راحتی به عنوان توسعه دهنده برنامه.
سرور مدیریت API ابزارهایی را برای افزودن و پیکربندی پراکسیهای API، راهاندازی محصولات API و مدیریت توسعهدهندگان برنامه و برنامههای سرویس گیرنده ارائه میکند. بسیاری از نگرانی های مدیریتی رایج را از خدمات باطن شما حذف می کند. وقتی یک پراکسی API اضافه میکنید، میتوانید خطمشیهایی را برای افزودن امنیت، محدود کردن نرخ، میانجیگری، حافظه پنهان و غیره روی پراکسی API اعمال کنید. همچنین میتوانید با اعمال اسکریپتهای سفارشی، برقراری تماس با APIها و سرویسهای شخص ثالث و غیره، رفتار پراکسی API خود را سفارشی کنید. برای اطلاعات بیشتر به درک API ها و پراکسی های API مراجعه کنید.
اگر توسعهدهنده Node.js هستید، میتوانید یکپارچه ماژولهای Node.js خود را به Edge اضافه کنید تا API و API mashup ایجاد کنید، و در عین حال از مزایای Edge، از تبدیل پیام گرفته تا امنیت و تجزیه و تحلیل، استفاده کنید.
نظارت بر لبه و تجزیه و تحلیل
Apigee Edge API Analytics ابزارهای قدرتمندی را برای مشاهده روند استفاده کوتاه مدت و بلندمدت از API های شما فراهم می کند. میتوانید مخاطبان خود را بر اساس توسعهدهندگان و برنامههای برتر تقسیمبندی کنید، استفاده از روش API را درک کنید تا بدانید کجا باید سرمایهگذاری کنید، و گزارشهای سفارشی درباره اطلاعات در سطح تجاری یا عملیاتی ایجاد کنید.
با عبور داده ها از Edge، چندین نوع اطلاعات پیش فرض از جمله URL، IP، شناسه کاربر برای اطلاعات تماس API، تأخیر، داده های خطا و غیره جمع آوری می شود. میتوانید خطمشیهایی برای اضافه کردن اطلاعات دیگر، مانند سرصفحهها، پارامترهای پرس و جو، و بخشهایی از یک درخواست یا پاسخ استخراجشده از XML یا JSON ایجاد کنید. این اطلاعات به صورت ناهمزمان از جریان درخواست/پاسخ واقعی جمعآوری میشود و بنابراین تأثیری بر عملکرد API ندارد.
رابط کاربری مدیریت به شما امکان می دهد معیارها و ابعاد متعددی را در یک مرورگر مشاهده کنید، همانطور که در شکل زیر نشان داده شده است:
با این حال، شما همچنین می توانید از طریق یک رابط خط فرمان یا از طریق API های RESTful به سرویس Analytics دسترسی داشته باشید و آن را کنترل کنید. برای اطلاعات بیشتر به نمای کلی API Analytics مراجعه کنید.
اکوسیستم توسعه دهنده لبه
Apigee Edge خدمات توسعه دهنده ای را ارائه می دهد که شما را قادر می سازد:
- جامعه توسعه دهندگان برنامه را که از خدمات شما استفاده می کنند، مدیریت کنید.
- با توسعه دهندگان داخلی و خارجی کار کنید و روابط را با مدل های مالی رسمی کنید.
- توسعه دهندگان داخل هواپیما و ایجاد یک پورتال توسعه دهنده. توسعه دهندگان برنامه برای دسترسی به اسناد API به پورتال شما متصل می شوند تا درباره محصولات API در دسترس عموم شما بیشتر بیاموزند و کلیدهای API را مدیریت کنند.
هر مشتری Edge میتواند پورتال توسعهدهنده خود را، چه در فضای ابری و چه در محل، با Apigee Edge for Private Cloud ایجاد کند.
Apigee Edge شما را قادر می سازد دو نوع پورتال ایجاد کنید:
- پورتال یکپارچه که می تواند فورا فراهم شود. به ساخت پورتال یکپارچه خود مراجعه کنید.
- پورتال مبتنی بر دروپال به ساخت پورتال مبتنی بر دروپال مراجعه کنید.
کسب درآمد
قابلیتهای کسب درآمد، زیرساختها و روابط مالی را فراهم میکنند تا جامعه برنامهنویس شما را به کانالی واقعی برای داراییهای دیجیتال شما تبدیل کند. با کسب درآمد، میتوانید انواع طرحهای نرخی ایجاد کنید که از توسعهدهندگان برای استفاده از محصولات API خود هزینه دریافت میکنند یا به شما امکان میدهند در سناریوهای اشتراک درآمد به توسعهدهندگان پول پرداخت کنید.
طرحها شامل طرحهای پیشپرداخت، طرحهای پسپرداخت، طرحهای کارمزد ثابت، طرحهای نرخ متغیر، طرحهای «رایگان»، طرحهای متناسب با توسعهدهندگان خاص، طرحهایی که گروههایی از توسعهدهندگان را پوشش میدهند، و غیره است. علاوه بر این، کسب درآمد شامل تسهیلات گزارش دهی و صورتحساب است.
برای اطلاعات بیشتر، به نمای کلی کسب درآمد مراجعه کنید.
طعم های لبه
Apigee Edge در طعم های زیر عرضه می شود:
- Public Cloud: یک نسخه SAAS میزبانی شده که در آن Apigee محیط را حفظ میکند و به شما امکان میدهد روی ساخت سرویسهای خود و تعریف API برای آن سرویسها تمرکز کنید.
- Private Cloud: یک نصب در محل که در آن محیط سخت افزاری را کنترل می کنید و مسئولیت نصب، ارتقا، نگهداری و سایر فرآیندهای اداری را بر عهده دارید.
اگر به نسخه هیبریدی Apigee ما علاقه دارید، موضوعات زیر Apigee X را ببینید:
از نظر عملکردی، نسخه های عمومی ابری و خصوصی ابری بسیار شبیه به هم هستند. با این حال، نسخه Private Cloud از همه ویژگیهای نسخه Public Cloud پشتیبانی نمیکند . ویژگی هایی که توسط Private Cloud پشتیبانی نمی شوند عبارتند از:
- اهداف میزبانی شده
- برنامه های افزودنی
- پورتال های توسعه دهنده یکپارچه ( توجه : پورتال های توسعه دهنده مبتنی بر دروپال پشتیبانی می شوند)
- نظارت API
- حس
برای لیستی از تفاوتهای طعمها، به مقایسه محصولات Apigee مراجعه کنید.
همچنین تفاوتهای جزئی بین APIها وجود دارد، همانطور که در تفاوتهای بین Edge برای Public Cloud API و Private Cloud API توضیح داده شده است.
Public Cloud از اکانت های رایگان و پولی پشتیبانی می کند. Private Cloud به حساب های پولی نیاز دارد.
برای پشتیبانی کامل از نصب در محل، نسخه Private Cloud شامل اجزایی مانند سرور مدیریت Apigee، پایگاه داده Apache Cassandra NoSQL، سرور OpenLDAP، روتر پیام و پردازشگر پیام است.
، شما در حال مشاهده اسناد Apigee Edge هستید.
به مستندات Apigee X بروید . اطلاعات
Apigee Edge پلتفرمی برای توسعه و مدیریت APIها است. Edge با ارائه خدمات با یک لایه پروکسی، یک انتزاع یا نمای برای APIهای سرویس باطن شما فراهم می کند و امنیت، محدودیت نرخ، سهمیه، تجزیه و تحلیل و موارد دیگر را فراهم می کند.
برای مثال، میتوانید یک پخش اینترنتی در مورد نحوه استفاده Walgreens از APIها و Apigee Edge برای ارائه یک اکوسیستم برنامه غنی در مورد چاپ عکس، نسخهها و سایر خدماتی که ارائه میکنند، مشاهده کنید .
شتاب دیجیتال
این ویدیو به شما یک نمای سریع از اینکه چگونه Apigee به شما کمک می کند تا به یک تجارت دیجیتالی تبدیل شوید، می دهد.
انتخاب بین مدیریت سرویس و مدیریت API
این ویدیو به شما کمک می کند تا تفاوت های مهم بین مدیریت سرویس و مدیریت API را درک کنید. کسب و کار
در دسترس قرار دادن خدمات خود در وب
امروزه شرکتها میخواهند خدمات پشتیبان خود را در وب در دسترس قرار دهند تا این خدمات توسط برنامههایی که روی دستگاههای تلفن همراه و دسکتاپ اجرا میشوند، مصرف شوند. ممکن است یک شرکت بخواهد خدماتی را ارائه دهد که اطلاعات مربوط به قیمت و در دسترس بودن محصول، خدمات فروش و سفارش، خدمات ردیابی سفارش و سایر خدمات مورد نیاز برنامه های مشتری را ارائه می دهد.
شرکت ها اغلب خدمات را به عنوان مجموعه ای از نقاط پایانی HTTP در معرض نمایش می گذارند. سپس توسعه دهندگان برنامه های مشتری درخواست های HTTP را به این نقاط پایانی می دهند. بسته به نقطه پایانی، سرویس ممکن است دادههای فرمتشده به صورت XML یا JSON را به برنامه مشتری بازگرداند.
برنامههای سرویس گیرندهای که این خدمات را مصرف میکنند میتوانند بهعنوان برنامههای مستقل برای یک دستگاه تلفن همراه یا رایانه لوحی، بهعنوان برنامههای HTML5 که در مرورگر اجرا میشوند، یا بهعنوان هر نوع برنامه دیگری که میتواند به یک نقطه پایانی HTTP درخواست بدهد و دادههای پاسخ را مصرف کند، پیادهسازی شود. این برنامهها ممکن است توسط همان شرکتی که این سرویسها را افشا کرده است، یا توسعهدهندگان برنامههای شخص ثالثی که از سرویسهای در دسترس عموم استفاده میکنند، توسعه و منتشر کنند.
تصویر زیر این نوع مدل را نشان می دهد:
از آنجا که ارائه دهندگان خدمات خود را از طریق وب در دسترس قرار می دهند، باید اطمینان حاصل کنند که تمام اقدامات لازم را برای ایمن سازی و محافظت از خدمات خود در برابر دسترسی غیرمجاز انجام داده اند. به عنوان یک ارائه دهنده خدمات، موارد زیر را در نظر بگیرید:
- امنیت: چگونه دسترسی به خدمات خود را برای جلوگیری از دسترسی غیرمجاز کنترل خواهید کرد؟
- سازگاری: آیا سرویس های شما در پلتفرم ها و دستگاه های مختلف کار خواهند کرد؟
- قابلیت اندازه گیری: چگونه می توانید خدمات خود را برای اطمینان از در دسترس بودن آنها نظارت کنید؟
- کسب درآمد: چگونه می توانید مشتریان را برای دسترسی به خدمات خود ردیابی و صورتحساب بگیرید؟
- و بسیاری ملاحظات دیگر
پس از انتشار یک برنامه مشتری که به هر سرویسی دسترسی داشت، ارائهدهنده خدمات موظف است مطمئن شود که آن سرویسها در طول زمان و با افزودن، اصلاح یا حذف آن سرویسها به کار خود ادامه میدهند. ارائهدهنده خدمات همچنین باید راهی برای آگاه ساختن توسعهدهندگان برنامه از هرگونه تغییر در سرویسها داشته باشد تا اطمینان حاصل شود که برنامههای مشتری با آن سرویسها همگام میشوند.
توسعه دهندگان برنامه های مشتری هنگام تلاش برای استفاده از خدمات ارائه دهندگان مختلف با چالش هایی مواجه می شوند. امروزه فناوریهای زیادی برای استفاده توسط یک ارائهدهنده خدمات برای نمایش خدماتش در دسترس است. ممکن است همان برنامه مشتری مجبور باشد از یک مکانیسم برای مصرف یک سرویس از یک ارائه دهنده، و مکانیسم متفاوتی برای مصرف سرویس از یک ارائه دهنده متفاوت استفاده کند. توسعه دهندگان برنامه حتی می توانند با شرایطی روبرو شوند که مجبور شوند از مکانیسم های مختلفی برای مصرف خدمات از یک ارائه دهنده استفاده کنند.
خدمات را از طریق Apigee Edge در دسترس قرار دهید
Apigee Edge شما را قادر می سازد تا دسترسی ایمن به خدمات خود را با یک API کاملاً تعریف شده ارائه دهید که در همه سرویس های شما بدون توجه به اجرای سرویس سازگار است. یک API سازگار:
- استفاده از خدمات شما را برای توسعه دهندگان برنامه آسان می کند.
- شما را قادر می سازد تا اجرای سرویس Backend را بدون تأثیر بر API عمومی تغییر دهید.
- به شما امکان می دهد از تجزیه و تحلیل، کسب درآمد، پورتال توسعه دهنده و سایر ویژگی های ساخته شده در Edge استفاده کنید.
تصویر زیر یک معماری را نشان میدهد که Edge درخواستهای برنامههای مشتری به خدمات باطن شما را مدیریت میکند:
به جای اینکه توسعه دهندگان برنامه مستقیماً خدمات شما را مصرف کنند، به یک پروکسی API ایجاد شده در Edge دسترسی دارند. پروکسی API به عنوان نگاشت یک نقطه پایانی HTTP در دسترس عموم به سرویس باطن شما عمل می کند. با ایجاد یک پروکسی API به Edge اجازه میدهید تا وظایف امنیتی و مجوز لازم برای محافظت از سرویسهای شما و همچنین تجزیه و تحلیل، نظارت و کسب درآمد از آن سرویسها را انجام دهد.
از آنجایی که توسعهدهندگان برنامه درخواستهای HTTP را بهجای مستقیماً به سرویسهای شما، به یک پراکسی API ارسال میکنند، توسعهدهندگان نیازی به دانستن چیزی در مورد اجرای سرویسهای شما ندارند. تنها چیزی که توسعه دهنده باید بداند این است:
- URL نقطه پایانی پروکسی API.
- هر پارامتر پرس و جو، سرصفحه یا پارامتر بدنه که در یک درخواست ارسال می شود.
- هر گونه احراز هویت و اعتبار مورد نیاز.
- قالب پاسخ، از جمله قالب داده پاسخ، مانند XML یا JSON.
پروکسی API توسعهدهنده برنامه را از سرویس باطن شما جدا میکند. بنابراین، تا زمانی که API عمومی ثابت بماند، میتوانید اجرای سرویس را تغییر دهید. با حفظ یک API یک frontend ثابت، برنامه های مشتری موجود بدون توجه به تغییرات در backend به کار خود ادامه می دهند.
میتوانید از خطمشیهای روی پراکسی API برای افزودن عملکرد به یک سرویس بدون نیاز به ایجاد هیچ تغییری در سرویس باطن استفاده کنید. به عنوان مثال، میتوانید برای انجام تبدیل دادهها و فیلتر کردن، افزودن امنیت، اجرای منطق شرطی یا کد سفارشی و انجام بسیاری از اقدامات دیگر، سیاستهایی را به پروکسی خود اضافه کنید. نکته مهمی که باید به خاطر بسپارید این است که سیاستها را روی Edge پیادهسازی میکنید، نه در سرور باطن خود.
برای اطلاعات بیشتر، به درک API ها و پراکسی های API مراجعه کنید.
یک محصول API ایجاد کنید
یک پروکسی API نقطه پایانی HTTP در Apigee Edge است که توسعه دهندگان برای دسترسی به خدمات باطن شما از آن استفاده می کنند. در حالی که این امکان وجود دارد، شما معمولاً پراکسی های API فردی را در دسترس قرار نمی دهید. در عوض، یک یا چند پروکسی API را در یک محصول API گروه بندی می کنید.
یک محصول API مجموعه ای از پراکسی های API است که با یک طرح خدمات ترکیب شده است. این طرح خدمات میتواند محدودیتهای دسترسی را برای پراکسیهای API تعیین کند، امنیت را فراهم کند، امکان نظارت و تجزیه و تحلیل را فراهم کند و ویژگیهای اضافی را ارائه دهد. محصولات API همچنین مکانیزم مرکزی هستند که Edge برای مجوز و کنترل دسترسی به API های شما استفاده می کند.
هنگام ایجاد محصولات API انعطاف پذیری زیادی دارید. به عنوان مثال، چندین محصول API می توانند یک پروکسی API را به اشتراک بگذارند. شکل زیر سه محصول API را نشان می دهد. توجه داشته باشید که همه محصولات اجازه دسترسی به API Proxy 3 را می دهند، اما فقط محصول A اجازه دسترسی به API Proxy 1 را می دهد.
میتوانید ویژگیهای مختلفی را روی هر محصول API تنظیم کنید. برای مثال، ممکن است یک محصول API را با محدودیت دسترسی کم، مانند 1000 درخواست در روز، با قیمت مقرون به صرفه در دسترس قرار دهید. سپس محصول API دیگری را منتشر می کنید که دسترسی به همان پراکسی API را فراهم می کند، اما با محدودیت دسترسی بسیار بالاتر، با قیمت بالاتر. یا، ممکن است یک محصول API رایگان ایجاد کنید که امکان دسترسی فقط خواندنی به خدمات شما را فراهم کند، و سپس یک محصول API را به همان پراکسیهای API که امکان دسترسی خواندن/نوشتن را میدهد، بفروشید.
برای اطلاعات بیشتر، به مدیریت محصولات API مراجعه کنید.
به یک برنامه سمت سرویس گیرنده اجازه دهید به محصول API شما دسترسی داشته باشد
وقتی توسعه دهندگان برنامه تصمیم می گیرند که می خواهند به خدمات شما دسترسی داشته باشند، ابتدا باید برنامه مشتری خود را با محصول API شما ثبت کنند.
پس از ثبت نام، یک توسعهدهنده برنامه یک کلید API دریافت میکند که باید آن را در هر درخواست به یک پروکسی API موجود در محصول API اضافه کند. آن کلید احراز هویت شده است و در صورت موفقیت آمیز بودن احراز هویت، به درخواست اجازه داده می شود تا به سرویس پشتیبان شما دسترسی پیدا کند.
در هر زمان میتوانید کلید را لغو کنید تا برنامه مشتری دیگر به خدمات شما دسترسی نداشته باشد. یا میتوانید برای یک کلید محدودیت زمانی تعیین کنید تا توسعهدهنده باید کلید را پس از یک زمان خاص تازهسازی کند.
شما تصمیم می گیرید که چگونه به درخواست های ثبت نام از سوی توسعه دهندگان برای دسترسی به محصولات API خود رسیدگی کنید. با استفاده از خدمات توسعه دهنده Apigee Edge، می توانید فرآیند ثبت نام را خودکار کنید. یا می توانید از یک فرآیند دستی برای کنترل دسترسی استفاده کنید.
محصولات API را ایجاد کنید و آنها را در دسترس توسعه دهندگان قرار دهید
- یک یا چند پروکسی API ایجاد کنید که نشانیهای وب در دسترس عموم را به خدمات باطن شما نگاشت میکنند.
- یک محصول API ایجاد کنید که پراکسیهای API شما را جمع کند.
- پروکسی های API و محصول API خود را مستقر کنید.
- به توسعه دهندگان خود اطلاع دهید که محصول API در دسترس است.
هنگامی که توسعه دهندگان برنامه از در دسترس بودن محصول API شما مطلع شوند، آنها:
- برنامه های مشتری آنها را با محصول API خود ثبت کنید.
- یک کلید API برای محصول API دریافت کنید.
- از طریق پراکسیهای API (که در محصول API قرار دارند) درخواستها را به خدمات خود ارسال کنید و با هر درخواست کلید API را ارسال کنید.
اجزای Apigee Edge
Apigee Edge متشکل از زمان اجرا، نظارت و تجزیه و تحلیل API و خدمات توسعه دهنده است که در کنار هم زیرساخت جامعی را برای ایجاد، امنیت، مدیریت و عملیات API فراهم می کنند.
شکل زیر خدمات Edge را نشان می دهد:
زمان اجرا Edge API
خدمات Apigee Edge API همه چیز در مورد ایجاد و مصرف API است، چه در حال ساخت پروکسی API به عنوان یک ارائه دهنده خدمات باشید و چه از API، SDK، و سایر سرویس های راحتی به عنوان توسعه دهنده برنامه.
سرور مدیریت API ابزارهایی را برای افزودن و پیکربندی پراکسیهای API، راهاندازی محصولات API و مدیریت توسعهدهندگان برنامه و برنامههای سرویس گیرنده ارائه میکند. بسیاری از نگرانی های مدیریتی رایج را از خدمات باطن شما حذف می کند. وقتی یک پراکسی API اضافه میکنید، میتوانید خطمشیهایی را برای افزودن امنیت، محدود کردن نرخ، میانجیگری، حافظه پنهان و غیره روی پراکسی API اعمال کنید. همچنین میتوانید با اعمال اسکریپتهای سفارشی، برقراری تماس با APIها و سرویسهای شخص ثالث و غیره، رفتار پراکسی API خود را سفارشی کنید. برای اطلاعات بیشتر به درک API ها و پراکسی های API مراجعه کنید.
اگر توسعهدهنده Node.js هستید، میتوانید یکپارچه ماژولهای Node.js خود را به Edge اضافه کنید تا API و API mashup ایجاد کنید، و در عین حال از مزایای Edge، از تبدیل پیام گرفته تا امنیت و تجزیه و تحلیل، استفاده کنید.
نظارت بر لبه و تجزیه و تحلیل
Apigee Edge API Analytics ابزارهای قدرتمندی را برای مشاهده روند استفاده کوتاه مدت و بلندمدت از API های شما فراهم می کند. میتوانید مخاطبان خود را بر اساس توسعهدهندگان و برنامههای برتر تقسیمبندی کنید، استفاده از روش API را درک کنید تا بدانید کجا باید سرمایهگذاری کنید، و گزارشهای سفارشی درباره اطلاعات در سطح تجاری یا عملیاتی ایجاد کنید.
با عبور داده ها از Edge، چندین نوع اطلاعات پیش فرض از جمله URL، IP، شناسه کاربر برای اطلاعات تماس API، تأخیر، داده های خطا و غیره جمع آوری می شود. میتوانید خطمشیهایی برای اضافه کردن اطلاعات دیگر، مانند سرصفحهها، پارامترهای پرس و جو، و بخشهایی از یک درخواست یا پاسخ استخراجشده از XML یا JSON ایجاد کنید. این اطلاعات به صورت ناهمزمان از جریان درخواست/پاسخ واقعی جمعآوری میشود و بنابراین تأثیری بر عملکرد API ندارد.
رابط کاربری مدیریت به شما امکان می دهد معیارها و ابعاد متعددی را در یک مرورگر مشاهده کنید، همانطور که در شکل زیر نشان داده شده است:
با این حال، شما همچنین می توانید از طریق یک رابط خط فرمان یا از طریق API های RESTful به سرویس Analytics دسترسی داشته باشید و آن را کنترل کنید. برای اطلاعات بیشتر به نمای کلی API Analytics مراجعه کنید.
اکوسیستم توسعه دهنده لبه
Apigee Edge خدمات توسعه دهنده ای را ارائه می دهد که شما را قادر می سازد:
- جامعه توسعه دهندگان برنامه را که از خدمات شما استفاده می کنند، مدیریت کنید.
- با توسعه دهندگان داخلی و خارجی کار کنید و روابط را با مدل های مالی رسمی کنید.
- توسعه دهندگان داخل هواپیما و ایجاد یک پورتال توسعه دهنده. توسعه دهندگان برنامه برای دسترسی به اسناد API به پورتال شما متصل می شوند تا درباره محصولات API در دسترس عموم شما بیشتر بیاموزند و کلیدهای API را مدیریت کنند.
هر مشتری Edge میتواند پورتال توسعهدهنده خود را، چه در فضای ابری و چه در محل، با Apigee Edge for Private Cloud ایجاد کند.
Apigee Edge شما را قادر می سازد دو نوع پورتال ایجاد کنید:
- پورتال یکپارچه که می تواند فورا فراهم شود. به ساخت پورتال یکپارچه خود مراجعه کنید.
- پورتال مبتنی بر دروپال به ساخت پورتال مبتنی بر دروپال مراجعه کنید.
کسب درآمد
قابلیتهای کسب درآمد، زیرساختها و روابط مالی را فراهم میکنند تا جامعه برنامهنویس شما را به کانالی واقعی برای داراییهای دیجیتال شما تبدیل کند. با کسب درآمد، میتوانید انواع طرحهای نرخی ایجاد کنید که از توسعهدهندگان برای استفاده از محصولات API خود هزینه دریافت میکنند یا به شما امکان میدهند در سناریوهای اشتراک درآمد به توسعهدهندگان پول پرداخت کنید.
طرحها شامل طرحهای پیشپرداخت، طرحهای پسپرداخت، طرحهای کارمزد ثابت، طرحهای نرخ متغیر، طرحهای «رایگان»، طرحهای متناسب با توسعهدهندگان خاص، طرحهایی که گروههایی از توسعهدهندگان را پوشش میدهند، و غیره است. علاوه بر این، کسب درآمد شامل تسهیلات گزارش دهی و صورتحساب است.
برای اطلاعات بیشتر، به نمای کلی کسب درآمد مراجعه کنید.
طعم های لبه
Apigee Edge در طعم های زیر عرضه می شود:
- Public Cloud: یک نسخه SAAS میزبانی شده که در آن Apigee محیط را حفظ میکند و به شما امکان میدهد روی ساخت سرویسهای خود و تعریف API برای آن سرویسها تمرکز کنید.
- Private Cloud: یک نصب در محل که در آن محیط سخت افزاری را کنترل می کنید و مسئولیت نصب، ارتقا، نگهداری و سایر فرآیندهای اداری را بر عهده دارید.
اگر به نسخه هیبریدی Apigee ما علاقه دارید، موضوعات زیر Apigee X را ببینید:
از نظر عملکردی، نسخه های عمومی ابری و خصوصی ابری بسیار شبیه به هم هستند. با این حال، نسخه Private Cloud از همه ویژگیهای نسخه Public Cloud پشتیبانی نمیکند . ویژگی هایی که توسط Private Cloud پشتیبانی نمی شوند عبارتند از:
- اهداف میزبانی شده
- برنامه های افزودنی
- پورتال های توسعه دهنده یکپارچه ( توجه : پورتال های توسعه دهنده مبتنی بر دروپال پشتیبانی می شوند)
- نظارت API
- حس
برای لیستی از تفاوتهای طعمها، به مقایسه محصولات Apigee مراجعه کنید.
همچنین تفاوتهای جزئی بین APIها وجود دارد، همانطور که در تفاوتهای بین Edge برای Public Cloud API و Private Cloud API توضیح داده شده است.
Public Cloud از اکانت های رایگان و پولی پشتیبانی می کند. Private Cloud به حساب های پولی نیاز دارد.
برای پشتیبانی کامل از نصب در محل، نسخه Private Cloud شامل اجزایی مانند سرور مدیریت Apigee، پایگاه داده Apache Cassandra NoSQL، سرور OpenLDAP، روتر پیام و پردازشگر پیام است.