آشنایی با میاناهای برنامه‌سازی کاربردی و پراکسی‌های میانای برنامه‌سازی کاربردی

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید. اطلاعات

‫Apigee Edge به شما امکان می‌دهد به‌آسانی و به‌سرعت میاناهای برنامه‌سازی کاربردی RESTful بسازید که توسعه‌دهندگان نرم‌افزار بتوانند از آن‌ها استفاده کنند. با ساختن پراکسی‌های API که به‌عنوان «نمای» مدیریت‌شده برای سرویس‌های زیرینه عمل می‌کنند، APIها را در Edge نمایان می‌کنید. این موضوع درباره رابطه بین «میاناهای برنامه‌سازی کاربردی» و پراکسی‌های «میانای برنامه‌سازی کاربردی» در Apigee Edge بحث می‌کند.

ویدیو: برای آشنایی با پراکسی‌های API، این ویدیو کوتاه را ببینید.

«میانای برنامه‌سازی کاربردی» چیست؟

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

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

‫Apigee Edge به شما امکان می‌دهد میاناهای برنامه‌سازی کاربردی بسازید و اگر ازقبل میانای برنامه‌سازی کاربردی دارید، آن‌ها را مستقیماً نمایان کنید، ضمن اینکه لایه مدیریت و نمایان‌سازی را اضافه می‌کنید. اگر سرویس‌های فعال HTTP دارید، مثل سرویس‌های وب مبتنی بر SOA، این سرویس‌ها را نیز می‌توانید ازطریق Apigee Edge به‌عنوان API عرضه کنید.

‫Edge همچنین به شما امکان می‌دهد با پیاده‌سازی برنامه‌های میزبانی‌شده در پلاتفرم «سرویس‌های API» میاناهای برنامه‌سازی کاربردی بسازید--بدون اینکه سرویس زیرینه‌ای درگیر شود. می‌توانید این برنامه‌ها را در JavaScript،‏ Java، و در Node.js بسازید.

پراکسی میانای برنامه‌سازی کاربردی چیست؟

با پیاده‌سازی پراکسی‌های API، میاناهای برنامه‌سازی کاربردی را در Apigee Edge نمایان می‌کنید. کارگزاران میانای برنامه‌سازی کاربردی، میانای برنامه‌سازی کاربردی رو به برنامه را از خدمات زیرینه شما جدا می‌کنند و این برنامه‌ها را از تغییرات کد زیرینه محافظت می‌کنند. هم‌زمان با ایجاد تغییرات زیرساختی در سرویس‌هایتان، برنامه‌ها بدون هیچ وقفه‌ای به فراخوانی همان API ادامه می‌دهند.

در پیکربندی پراکسی API، دو نوع نقطه پایانی وجود دارد:

  • ProxyEndpoint: روش مصرف کردن میاناهای برنامه‌سازی کاربردی شما توسط برنامه‌های مشتری را تعریف می‌کند. شما «نقطه پایان پراکسی» را پیکربندی می‌کنید تا نشانی وب پراکسی API خود را تعریف کنید. نقطه پایان پراکسی همچنین تعیین می‌کند که آیا برنامه‌ها ازطریق HTTP یا HTTPS به پراکسی API دسترسی داشته باشند. معمولاً خط‌مشی‌ها را به ProxyEndpoint پیوست می‌کنید تا امنیت، بررسی سهمیه، و انواع دیگر کنترل دسترسی و محدود کردن نرخ را اعمال کنید.
  • TargetEndpoint: روش تعامل میانای برنامه‌سازی کاربردی با سرویس‌های زیرین شما را تعریف می‌کند. ‫TargetEndpoint را پیکربندی می‌کنید تا درخواست‌ها را به سرویس زیرینه مناسب ارسال کند، ازجمله تعریف هرگونه تنظیمات امنیتی، پروتکل HTTP یا HTTPS، و سایر اطلاعات اتصال. می‌توانید خط‌مشی‌ها را به TargetEndpoint پیوست کنید تا مطمئن شوید پیام‌های پاسخ برای برنامه‌ای که درخواست اولیه را ارسال کرده است به‌درستی قالب‌بندی شده‌اند.

می‌توانید کارگزاران میانای برنامه‌سازی کاربردی را همان‌طور که در گراف زیر نشان داده شده است تجسم کنید:

درخواست‌های HTTP ازطریق نقطه پایان درخواست پراکسی وارد می‌شوند، به نقطه پایان درخواست هدف منتقل می‌شوند، و سپس به سرویس‌های زیرینه ارسال می‌شوند. پاسخ‌های HTTP ازطریق نقطه پایانی پاسخ هدف وارد می‌شوند، به نقطه پایانی پاسخ پراکسی منتقل می‌شوند، و سپس به مشتری برمی‌گردند.

چگونه یک پراکسی API ایجاد می‌کنید؟

پراکسی API از بسته‌ای از فایل‌های پیکربندی XML و کد (مانند جاوااسکریپت و جاوا) تشکیل شده است. ‫Apigee چندین روش برای ایجاد پراکسی‌های API دراختیارتان قرار می‌دهد، ازجمله:

  • استفاده از «میانای کاربر» مدیریت Edge برای تعریف پراکسی API در «میانای کاربر گرافیکی» (GUI). برای اطلاعات بیشتر، ساختن کارگزار میانای برنامه‌سازی کاربردی ساده را ببینید.
  • ایجاد فایل‌های XML، همراه با هر فایل پشتیبان دیگری، که پراکسی API شما را تعریف می‌کند و سپس وارد کردن آن‌ها به Edge.
  • استفاده از Edge management API برای ایجاد پراکسی‌های API با انجام مجموعه‌ای از درخواست‌های REST به Edge.
  • برنامه Node.js را به‌عنوان پراکسی مستقر کنید. استقرار برنامه خوداتکای Node.js را ببینید.

خط‌مشی چیست؟

‫Edge به شما امکان می‌دهد رفتار میانای برنامه‌سازی کاربردی را بدون نوشتن کد بااستفاده از خط‌مشی‌ها کنترل کنید. خط‌مشی مانند واحدی است که عملکرد مدیریتی خاص و محدودی را به‌عنوان بخشی از جریان درخواست/پاسخ کارگزار اجرا می‌کند. خط‌مشی‌ها به‌گونه‌ای طراحی شده‌اند که به شما امکان می‌دهند به‌راحتی و به‌طور قابل‌اعتماد انواع رایج قابلیت‌های مدیریت را به میانای برنامه‌سازی کاربردی اضافه کنید. خط‌مشی‌ها ویژگی‌هایی مانند امنیت، محدود کردن نرخ، تبدیل، و قابلیت‌های میانجی‌گری را ارائه می‌دهند و شما را از کدنویسی و نگهداری این عملکرد به‌تنهایی بی‌نیاز می‌کنند.

ایجاد اولین پراکسی میانای برنامه‌سازی کاربردی

‫Apigee مجموعه‌ای از آموزش‌های گام‌به‌گام را ارائه می‌دهد که می‌توانید از آن‌ها برای ایجاد اولین میانای برنامه‌سازی کاربردی خود استفاده کنید. با ساختن اولین پراکسی میانای برنامه‌سازی کاربردی شروع کنید.

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

بیشتر بدانید