درحال مشاهده اسناد Apigee Edge هستید.
به
اسناد Apigee X بروید. اطلاعات
می‌توانید از افزونه‌ها برای ادغام منابع خارجی در پراکسی‌های API خود استفاده کنید. برای مثال، می‌توانید سرویس‌های Google Cloud Platform مثل Google Cloud Storage را ادغام کنید. در زمان اجرا، یک پراکسی API از افزونه برای تبادل درخواست‌ها و پاسخ‌ها با منبع خارجی استفاده می‌کند.
چارچوب زمان اجرای افزونه
در زمان اجرا، افزونه به‌عنوان واسطه عمل می‌کند و درخواست‌ها و پاسخ‌های بین پراکسی API و منبع خارجی را پردازش می‌کند.
نمایی کلی از نحوه عملکرد پردازش ازطریق افزونه در زمان اجرا در اینجا آمده است.
- درخواست کارخواه به پراکسی API می‌رسد و جریان درخواست آن ازطریق خط‌مشی‌های پراکسی ادامه می‌یابد.
- جریان درخواست به خط‌مشی «نوشته راهنمای افزونه» در پراکسی می‌رسد که برای انتقال داده‌ها به افزونه‌ای که در محیط مستقر شده است پیکربندی شده است. این داده‌ها شامل مقادیری است که برای ارسال درخواست به منبع خارجی که افزونه نشان می‌دهد لازم است.
- افزونه درخواستی را به منبع خارجی ارسال می‌کند، سپس پاسخی دریافت می‌کند.
- افزونه پاسخ خود را به خط‌مشی «نوشته راهنمای افزونه» برمی‌گرداند، جایی که با کد پراکسی مدیریت می‌شود.
- جریان درخواست ازطریق پراکسی ادامه می‌یابد تا زمانی که پاسخی به مشتری برگرداند.
کار کردن با افزونه‌ها
هر افزونه با درنظر گرفتن منبع خارجی خاصی توسعه و پیکربندی می‌شود. برای استفاده از افزونه، سرپرست Apigee Edge و توسعه‌دهنده پراکسی API این مراحل سطح بالا را دنبال می‌کنند:
- سرپرست سازمان Apigee Edge افزونه را پیکربندی و مستقر می‌کند. آن‌ها آن را با مقادیر خاص نیازهای کسب‌وکار پیکربندی می‌کنند. این پیکربندی نمونه افزونه‌ای ایجاد می‌کند که برای استفاده توسعه‌دهنده پراکسی API متمرکز شده است. برای مثال، ممکن است افزونه‌ای را پیکربندی کنند تا به مخزن خاصی در Google Cloud Storage دسترسی پیدا کند، ازجمله اطلاعات اعتباری اصالت‌سنجی موردنیاز.
- توسعه‌دهنده پراکسی میانای برنامه‌سازی کاربردی با افزودن خط‌مشی «تماس با افزونه» به پراکسی، از افزونه پیکربندی‌شده در پراکسی میانای برنامه‌سازی کاربردی استفاده می‌کند. پیکربندی خط‌مشی
- از کدام افزونه پیکربندی‌شده استفاده شود.
- کنش‌های افزونه (این‌ها را به‌عنوان فراخوانی‌های تابع برای افزونه درنظر بگیرید) برای فراخوانی.
- پارامترهای کنش برای ارسال با تماس کنش. در زمان اجرا، خط‌مشی از افزونه برای دسترسی به منبع خارجی به‌عنوان بخشی از جریان پراکسی استفاده می‌کند.
مستندات مربوط به افزونه‌ها
موضوعات زیر اطلاعات بیشتری درباره افزونه‌ها ارائه می‌دهند:
- برای آشنایی عملی با افزونه‌ها، آموزش گام‌به‌گام: افزودن و استفاده از افزونه را ببینید.
- برای مرجع‌های افزونه‌های همراه با Apigee Edge، به مروری بر مرجع افزونه‌ها مراجعه کنید.
- برای مرجع‌های میانای برنامه‌سازی کاربردی مدیریتی که می‌توانید برای افزودن، برداشتن، و پیاده‌سازی افزونه‌ها استفاده کنید، میانای برنامه‌سازی کاربردی افزونه‌ها را ببینید.