نمایان کردن سرویس SOAP به‌عنوان پراکسی API

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

این موضوع توضیح می‌دهد که چگونه برای خدمات وب مبتنی بر SOAP کارگزاران API ایجاد کنید. در Edge می‌توانید دو نوع کارگزار نیابتی SOAP ایجاد کنید. یکی میانای RESTful را برای سرویس SOAP زیرینه تولید می‌کند و دیگری پیام SOAP را به زیرینه «عبور می‌دهد». هر دو تکنیک در این موضوع توضیح داده شده است.

این ویدیو یک نمایش کامل از تبدیل سرویس SOAP به سرویس REST با Apigee Edge بااستفاده از جادوگر پراکسی API ارائه می‌دهد. بااین‌حال، اگر می‌خواهید کنترل بیشتری روی تبدیل SOAP به REST داشته باشید، می‌توانید بااستفاده از خط‌مشی‌ها پراکسی بسازید. برای کسب اطلاعات بیشتر، آموزش گام‌به‌گام: ساخت دستی پراکسی میانای برنامه‌سازی کاربردی SOAP-to-REST در Apigee Edge را ببینید.

ایجاد پراکسی میانای برنامه‌سازی کاربردی RESTful برای سرویس مبتنی بر SOAP

این بخش توضیح می‌دهد که چگونه بااستفاده از گزینه REST به SOAP به REST در دستیار «ساختن پراکسی»، پراکسی RESTful SOAP API بسازید.

نمای کلی

گزینه REST به SOAP به REST فایل WSDL را پردازش می‌کند تا یک پراکسی API با قابلیت RESTful تولید کند. ‫Edge از WSDL عملیات پشتیبانی‌شده سرویس، پارامترهای ورودی، و غیره را تعیین می‌کند. ‫Edge روش HTTP را برای هر عملیات «حدس می‌زند». معمولاً Edge عملیات را به درخواست‌های GET ترجمه می‌کند که مزیت قابل ذخیره شدن در حافظه نهان را دارند. ‫Edge همچنین نقطه پایانی هدف زیرینه را راه‌اندازی می‌کند که می‌تواند برای هر عملیات SOAP متفاوت باشد.

برای این نوع پراکسی، Edge به‌طور خودکار مشخصات OpenAPI تولید می‌کند که می‌توانید از آن برای ایجاد مستندات میانای برنامه‌سازی کاربردی استفاده کنید.

مراحل اولیه

Edge

برای ایجاد پراکسی «میانای برنامه‌سازی کاربردی» RESTful برای سرویس مبتنی بر SOAP بااستفاده از «واسط کاربر Edge»:

  1. به سیستم apigee.com/edge وارد شوید.
  2. در نوار پیمایش سمت راست، توسعه > پراکسی‌های API را انتخاب کنید.
  3. روی +پراکسی کلیک کنید.
  4. روی خدمات SOAP کلیک کنید.
  5. در صفحه «جزئیات پراکسی»، فایل WSDL را ارائه دهید.
    فیلد شرح
    فایل WSDL ارائه دهید

    منبع WSDL را انتخاب کنید.

    • از نشانی وب (URL) - نشانی وب WSDL را وارد یا جای‌گذاری کنید.
    • از رایانه من - فایل WSDL را از فهرست راهنمای محلی خود بارگذاری کنید. درصورت وجود وابستگی می‌توانید چند فایل بارگذاری کنید.
  6. برای اعتبارسنجی WSDL، روی اعتبارسنجی کلیک کنید.
  7. جزئیات پراکسی زیر را وارد کنید:
    فیلد شرح
    نام نامی که برای API شما نمایش داده می‌شود. نویسه‌های الفباعددی، خط تیره (-)، یا زیرخط (_) را مشخص کنید.
    مسیر پایه

    تکه‌نشانی وب که پس‌از نشانی http(s)://[host] ‎ کارگزار نیابتی API شما ظاهر می‌شود. ‫Edge از نشانی وب مسیر پایه برای مطابقت و مسیریابی پیام‌های درخواست ورودی به پراکسی API مناسب استفاده می‌کند.

    NOTE: مسیر پایه کارگزار API به‌طور پیش‌فرض روی مقدار مشخص‌شده برای فیلد Name که به حروف کوچک تبدیل شده است تنظیم می‌شود.

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

    https://[host]/base_path/conditional_flow_path

    NOTE: مسیر پایه باید یکتا باشد؛ نمی‌توانید دو پراکسی API را با مسیر پایه یکسان پیاده‌سازی کنید. اگر یک پراکسی API مستقرشده را ویرایش کنید و مسیر پایه را روی همان مقدار مسیر پایه پراکسی API دیگری تنظیم کنید، Edge به‌طور خودکار پراکسی API را هنگام ذخیره کردن آن لغو استقرار می‌کند. قبل‌از اینکه بتوانید پراکسی API را مجدداً مستقر کنید، باید مسیر پایه را ویرایش کنید تا منحصربه‌فرد باشد.

    استفاده از کارت‌های جوکر در مسیرهای پایه

    از یک یا چند نویسه عام /*/ در مسیرهای پایه کارگزار نیابتی API استفاده کنید تا کارگزاران نیابتی API خود را در آینده ایمن کنید. برای مثال، مسیر پایه /team/*/members به مشتریان امکان می‌دهد https://[host]/team/blue/members و https://[host]/team/green/members را فراخوانی کنند بدون اینکه شما نیاز داشته باشید کارگزاران میانای برنامه‌سازی کاربردی جدیدی برای پشتیبانی از تیم‌های جدید ایجاد کنید. توجه داشته باشید که /**/ پشتیبانی نمی‌شود.
    شرح (اختیاری) شرح میانای برنامه‌سازی کاربردی.
  8. روی بعدی کلیک کنید.
  9. در صفحه خط‌مشی‌های مشترک جادوگر، موارد زیر را پیکربندی کنید:
    • الزامات مجوز امنیتی تحت امنیت: مجوز. افزودن امنیت را ببینید.
    • پشتیبانی از «هم‌رسانی منبع میان‌مبدئی» (CORS) در بخش امنیت: مرورگر. به افزودن پشتیبانی برای CORS مراجعه کنید.
    • سهمیه‌ها برای محافظت از سرویس زیرینه شما دربرابر ترافیک بالا در بخش Quota. سهمیه‌ها را ببینید. (اگر مجوز عبور انتخاب شده باشد، دردسترس نیست.)
  10. در صفحه عملیات WSDL، نوع پراکسی API REST به SOAP به REST را انتخاب کنید.

    جدولی ظاهر می‌شود که عملیات را که Edge در فایل WSDL «کشف کرده است» فهرست می‌کند. می‌توانید عملیاتی را که می‌خواهید در پراکسی API خود بگنجانید انتخاب و پیکربندی کنید. جدول در شکل زیر نشان داده شده است.

  11. نوع درگاهی را از منو کرکره‌ای انتخاب کنید تا مشخص کنید از کدام مجموعه عملیات می‌خواهید استفاده کنید. در WSDL، عناصر نوع درگاه عملیاتی را که می‌توانید در یک سرویس وب فراخوانی کنید تعریف می‌کنند.
  12. به‌صورت اختیاری، مسیر REST API را برای یک عملیات تغییر دهید. از مسیر به‌عنوان نام منبع در نشانی وب پروکسی API استفاده خواهد شد.
  13. درصورت تمایل، فعل (روش HTTP) مرتبط با عملیات را تغییر دهید.
  14. روی بعدی کلیک کنید.
  15. در صفحه میزبان‌های مجازی جادوگر، میزبان‌های مجازی را که نماینده API هنگام استقرار به آن‌ها ملحق می‌شود انتخاب کنید. برای اطلاعات بیشتر، درباره میزبان‌های مجازی را ببینید.
  16. روی بعدی کلیک کنید.
  17. محیط(های) استقرار را انتخاب کنید و روی ایجاد و استقرار
    کارگزار API جدید شما ایجاد می‌شود و در محیط انتخاب‌شده مستقر می‌شود.
  18. برای نمایش صفحه جزئیات کارگزار نیابتی API، روی ویرایش کارگزار نیابتی کلیک کنید.

Classic Edge (ابر خصوصی)

برای ایجاد یک پراکسی API با سبک RESTful برای سرویس مبتنی بر SOAP بااستفاده از «واسط کاربر Classic Edge»:

  1. به سیستم http://ms-ip:9000 وارد شوید، که در آن ms-ip نشانی IP یا نام ساناد گره «سرور مدیریت» است.
  2. در نوار پیمایش بالا، میاناهای برنامه‌سازی کاربردی > پراکسی‌های میانای برنامه‌سازی کاربردی را انتخاب کنید.
  3. روی + پراکسی API کلیک کنید.
  4. در جادوگر «ساختن پراکسی»، سرویس SOAP را انتخاب کنید.
  5. روی بعدی کلیک کنید.
  6. در صفحه «جزئیات»، این انتخاب‌ها را انجام دهید. پس‌از انتخاب WSDL، باید روی اعتبارسنجی کلیک کنید.
    در این فیلد این کار را انجام دهید
    WSDL

    منبع WSDL را انتخاب کنید.

    • نشانی وب - نشانی وب WSDL موردنظرتان را برای استفاده وارد کنید.
    • فایل - فایل WSDL را در سیستم فایل انتخاب کنید. در مواردی که فایل‌های وابسته اضافی وجود دارد، می‌توانید همه آن‌ها را انتخاب کنید.
    • نشانی وب نمونه - از فهرست WSDL برای خدمات وب دردسترس عمومی انتخاب کنید. این موارد برای امتحان کردن ویژگی‌های پراکسی SOAP/API در Edge مفید هستند.
    نام پراکسی

    این نام پراکسی‌ای است که ایجاد می‌کنید.
    مسیر پایه پراکسی

    تکه‌نشانی وب که پس‌از نشانی http(s)://[host] ‎ کارگزار نیابتی API شما ظاهر می‌شود. ‫Edge از نشانی وب مسیر پایه برای مطابقت و مسیریابی پیام‌های درخواست ورودی به پراکسی API مناسب استفاده می‌کند.

    توجه: مسیر پایه کارگزار API به‌طور پیش‌فرض روی مقدار مشخص‌شده برای فیلد Name که به حروف کوچک تبدیل شده است تنظیم می‌شود.

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

    https://[host]/base_path/conditional_flow_path

    توجه: مسیر پایه باید یکتا باشد؛ نمی‌توانید دو پراکسی API را با مسیر پایه یکسان پیاده‌سازی کنید. اگر یک پراکسی API مستقرشده را ویرایش کنید و مسیر پایه را روی همان مقدار مسیر پایه پراکسی API دیگری تنظیم کنید، Edge به‌طور خودکار پراکسی API را هنگام ذخیره کردن آن لغو استقرار می‌کند. قبل‌از اینکه بتوانید پراکسی API را مجدداً مستقر کنید، باید مسیر پایه را ویرایش کنید تا منحصربه‌فرد باشد.

    استفاده از کارت‌های جوکر در مسیرهای پایه

    از یک یا چند نویسه عام /*/ در مسیرهای پایه کارگزار نیابتی API استفاده کنید تا کارگزاران نیابتی API خود را در آینده ایمن کنید. برای مثال، مسیر پایه /team/*/members به مشتریان امکان می‌دهد https://[host]/team/blue/members و https://[host]/team/green/members را فراخوانی کنند بدون اینکه شما نیاز داشته باشید کارگزاران میانای برنامه‌سازی کاربردی جدیدی برای پشتیبانی از تیم‌های جدید ایجاد کنید. توجه داشته باشید که /**/ پشتیبانی نمی‌شود.
    شرح شرح مختصری از پراکسی.
  7. روی بعدی کلیک کنید.
  8. در صفحه WSDL، نوع پراکسی API REST to SOAP to REST را انتخاب کنید.

    جدولی ظاهر می‌شود که عملیات را که Edge در فایل WSDL «کشف کرده است» فهرست می‌کند. می‌توانید عملیاتی را که می‌خواهید در پراکسی API خود بگنجانید انتخاب و پیکربندی کنید. جدول در شکل زیر نشان داده شده است.

    در صفحه عملیات WSDL، نوع پراکسی API روی «REST به SOAP به REST» تنظیم شده است و جدولی یک ردیف از نتایج را با عملیات افزودن نشان می‌دهد.

  9. از ستون «نوع درگاه»، مجموعه عملیاتی را که می‌خواهید استفاده کنید انتخاب کنید. در WSDL، عناصر نوع درگاه عملیاتی را که می‌توانید در یک سرویس وب فراخوانی کنید تعریف می‌کنند.
  10. به‌صورت اختیاری، «روش HTTP» مرتبط با عملیات را تغییر دهید.

    توجه: Edge در تعیین روش HTTP برای استفاده در هر عملیات، «بهترین حدس» را می‌زند. ‫GET معمولاً ترجیح داده می‌شود زیرا درخواست‌های GET را می‌توان در حافظه نهان ذخیره کرد.
  11. درصورت تمایل، مسیر REST API را برای یک عملیات تغییر دهید. از مسیر به‌عنوان نام منبع در نشانی وب پروکسی API استفاده خواهد شد.
  12. برای افزودن امنیت، انتخاب میزبان‌های مجازی، و محیط استقرار، بقیه مراحل دستیار را دنبال کنید.
  13. در صفحه «ساخت»، روی ساخت و استقرار کلیک کنید. ‫Edge براساس WSDL کارگزار پراکسی API جدید را تولید و مستقر می‌کند.
  14. به صفحه خلاصه کارگزار پروکسی API جدید بروید. توجه داشته باشید که مجموعه‌ای از منابع براساس عملیات‌های شناسایی‌شده در فایل WSDL ساخته شده است.

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

درباره پراکسی نهایی

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

برای مثال، در سمت درخواست، از خط‌مشی AssignMessage برای تنظیم نشانی وب هدف استفاده می‌شود. در سمت پاسخ، خط‌مشی‌ها اجرا می‌شوند تا پاسخ را از XML به JSON تبدیل کنند، بخش بدنه SOAP پاسخ را در متغیری استخراج کنند، و پیام پاسخ را تنظیم کنند. این خط‌مشی‌ها (و خط‌مشی‌های دیگر) هنگام ایجاد پراکسی به‌طور خودکار اضافه می‌شوند.

مشخصات OpenAPI: برای مشاهده مشخصات OpenAPI تولیدشده به‌طور خودکار برای این پراکسی، به http(s)://[proxy_domain]/[proxy_base_path]/openapi.json بروید. بااین‌حال، تبدیل همیشه دقیق نیست، زیرا همه قوانین طرحواره XML را نمی‌توان در «مشخصات OpenAPI» نشان داد.

ایجاد پراکسی عبوری برای سرویس مبتنی بر SOAP

این بخش توضیح می‌دهد که چگونه بااستفاده از گزینه پراکسی گذر در چارگوش گفتگوی «ایجاد پراکسی جدید»، پراکسی گذر ایجاد کنید.

نمای کلی

گزینه «پراکسی عبوری» به شما امکان می‌دهد پراکسی‌ای ایجاد کنید که پیام SOAP را در درخواست به سرویس زیرینه «دست‌نخورده» منتقل می‌کند و ایجاد پراکسی برای سرویس وب مبتنی بر SOAP را بسیار آسان می‌کند. در پشت صحنه، Edge به‌طور خودکار هرگونه تبدیل و سایر فعالیت‌های جریان را برای شما انجام می‌دهد. برای مثال، اگر درخواست در قالب JSON باشد، Edge قبل‌از ارسال آن به سرویس با روش POST، اقداماتی برای تبدیل آن به پیام XML SOAP معتبر با فضای نام صحیح انجام می‌دهد. به‌همین ترتیب، وقتی سرویس پاسخ SOAP مبتنی بر XML برمی‌گرداند، Edge آن را قبل‌از برگرداندن به کارخواه به JSON ترجمه می‌کند. علاوه‌براین، Edge نقطه پایانی هدف زیرینه را راه‌اندازی می‌کند که می‌تواند برای هر عملیات SOAP متفاوت باشد.

برای این نوع پراکسی، Edge میزبان WSDL است و جریانی در پراکسی ایجاد می‌کند تا به شما امکان دهد به آن دسترسی داشته باشید. نشانی این WSDL میزبانی‌شده در Edge، http(s)://[proxy_domain]/[proxy_base_path]?wsdl، به نشانی وب نقطه پایان سرویس جدید برای کارخواهانی که سرویس SOAP را ازطریق پراکسی فراخوانی می‌کنند تبدیل می‌شود.

مراحل اولیه

Edge

برای ایجاد پراکسی عبوری برای سرویس مبتنی بر SOAP بااستفاده از «میانای کاربری Edge»:

  1. به سیستم apigee.com/edge وارد شوید.
  2. در نوار پیمایش سمت راست، توسعه > پراکسی‌های API را انتخاب کنید.
  3. روی +پراکسی کلیک کنید.
  4. روی خدمات SOAP کلیک کنید.
  5. در صفحه «جزئیات پراکسی»، جزئیات WSDL را ارائه دهید.
    فیلد شرح
    WSDL

    منبع WSDL را انتخاب کنید.

    • از نشانی وب (URL) - نشانی وب WSDL را وارد یا جای‌گذاری کنید.
    • از رایانه من - فایل WSDL را از فهرست راهنمای محلی خود بارگذاری کنید. درصورت وجود وابستگی می‌توانید چند فایل بارگذاری کنید.
    نام

    نام پراکسی API.
    مسیر پایه

    تکه نشانی وب پس‌از نشانی http(s)://[host] مربوط به پراکسی API شما. ‫Edge از نشانی وب مسیر پایه برای مطابقت و مسیریابی پیام‌های درخواست ورودی به پراکسی API مناسب استفاده می‌کند.

    توجه: برای توصیه‌های Apigee درباره نسخه‌بندی میانای برنامه‌سازی کاربردی، نسخه‌بندی را در کتاب الکترونیکی طراحی میانای برنامه‌سازی کاربردی وب: حلقه گمشده ببینید.

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

    https://[host]/base_path/conditional_flow_path

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

    استفاده از کارت عام در مسیرهای پایه

    می‌توانید از یک یا چند /*/ نویسه عام در مسیرهای پایه پراکسی API استفاده کنید تا پراکسی‌هایتان را برای آینده آماده کنید. برای مثال، مسیر پایه /team/*/members به مشتریان امکان می‌دهد https://[host]/team/blue/members و https://[host]/team/green/members را فراخوانی کنند بدون اینکه شما نیاز داشته باشید کارگزاران میانای برنامه‌سازی کاربردی جدیدی برای پشتیبانی از تیم‌های جدید ایجاد کنید. توجه داشته باشید که /**/ پشتیبانی نمی‌شود.

    توجه: مسیر پایه پراکسی API به‌طور پیش‌فرض روی مقدار مشخص‌شده برای فیلد «نام» که به حروف کوچک تبدیل شده است تنظیم می‌شود، مگراینکه محتوای فیلد «مسیر پایه» را به‌طور صریح ویرایش کنید.
    شرح (اختیاری) شرح میانای برنامه‌سازی کاربردی.
  6. روی بعدی کلیک کنید.
  7. در صفحه خط‌مشی‌های مشترک جادوگر، موارد زیر را پیکربندی کنید:
  8. در صفحه WSDL، نوع پراکسی API Pass-Through SOAP را انتخاب کنید.

  9. نوع درگاهی را از منو کرکره‌ای انتخاب کنید تا مشخص کنید از کدام مجموعه عملیات می‌خواهید استفاده کنید. در WSDL، عناصر نوع درگاه عملیاتی را که می‌توانید در یک سرویس وب فراخوانی کنید تعریف می‌کنند.
  10. روی بعدی کلیک کنید.
  11. در صفحه میزبان‌های مجازی جادوگر، میزبان‌های مجازی را که نماینده API هنگام استقرار به آن‌ها ملحق می‌شود انتخاب کنید. برای اطلاعات بیشتر، درباره میزبان‌های مجازی را ببینید.
  12. محیط(های) استقرار را انتخاب کنید و روی ایجاد و استقرار
    کلیک کنید کارگزار پراکسی جدید API شما ایجاد و در محیط انتخابی مستقر می‌شود.
  13. برای نمایش صفحه جزئیات کارگزار نیابتی API، روی ویرایش کارگزار نیابتی کلیک کنید.

Classic Edge (ابر خصوصی)

برای ایجاد یک پراکسی عبوری برای سرویس مبتنی بر SOAP بااستفاده از «واسط کاربر Edge کلاسیک»:

  1. به سیستم http://ms-ip:9000 وارد شوید، که در آن ms-ip نشانی IP یا نام ساناد گره «سرور مدیریت» است.
  2. در نوار پیمایش بالا، میاناهای برنامه‌سازی کاربردی > پراکسی‌های میانای برنامه‌سازی کاربردی را انتخاب کنید.
  3. روی + پراکسی API کلیک کنید.
  4. در جادوگر «ساختن پراکسی»، سرویس SOAP را انتخاب کنید.
  5. روی بعدی کلیک کنید.
  6. در صفحه «جزئیات»، این انتخاب‌ها را انجام دهید. پس‌از انتخاب WSDL، باید روی اعتبارسنجی کلیک کنید.
    در این فیلد این کار را انجام دهید
    WSDL

    منبع WSDL را انتخاب کنید.

    • نشانی وب - نشانی وب WSDL موردنظرتان را برای استفاده وارد کنید.
    • فایل - فایل WSDL را در سیستم فایل انتخاب کنید. در مواردی که فایل‌های وابسته اضافی وجود دارد، می‌توانید همه آن‌ها را انتخاب کنید.
    • نشانی وب نمونه - از فهرست WSDL برای خدمات وب دردسترس عمومی انتخاب کنید. این موارد برای امتحان کردن ویژگی‌های پراکسی SOAP/API در Edge مفید هستند.
    نام پراکسی

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

    توجه: «مسیر پایه پراکسی» به‌طور پیش‌فرض روی مقدار مشخص‌شده برای «نام پراکسی» تنظیم می‌شود که به حروف کوچک تبدیل شده است، مگر اینکه محتوای فیلد «مسیر پایه پراکسی» را به‌طور صریح ویرایش کنید.
    شرح شرح مختصری از پراکسی.

  8. روی بعدی کلیک کنید.
  9. در صفحه WSDL، نوع پراکسی API Pass-Through SOAP را انتخاب کنید.

    توجه: جدولی ظاهر می‌شود که هر عملیات WSDL و بار SOAP مربوط به آن را فهرست می‌کند. این بار مفید «عبور داده‌شده» به سرویس SOAP زیرینه است.

    در صفحه WSDL، نوع پراکسی API روی «گذر از SOAP» تنظیم شده است و فهرستی از عملکردها مثل GetQuote براساس نوع درگاه سازمان‌دهی شده است.
  10. از ستون «نوع درگاه»، مجموعه عملیاتی را که می‌خواهید استفاده کنید انتخاب کنید. در WSDL، عناصر نوع درگاه عملیاتی را که می‌توانید در یک سرویس وب فراخوانی کنید تعریف می‌کنند.
  11. برای افزودن امنیت، انتخاب میزبان‌های مجازی، و محیط استقرار، بقیه مراحل دستیار را دنبال کنید.
  12. در صفحه «ساخت»، روی ساخت و استقرار کلیک کنید. ‫Edge براساس WSDL کارگزار پراکسی API جدید را تولید و مستقر می‌کند.

درباره پراکسی نهایی

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

برای مثال، شکل زیر بخش «جریان پیش‌از نقطه پایانی هدف» را در پراکسی عبوری نشان می‌دهد. در سمت درخواست، از خط‌مشی AssignMessage برای تنظیم نشانی وب هدف استفاده می‌شود. در سمت پاسخ، خط‌مشی‌ها اجرا می‌شوند تا پاسخ را از XML به JSON تبدیل کنند، بخش بدنه SOAP پاسخ را در متغیری استخراج کنند، و پیام پاسخ را تنظیم کنند. این خط‌مشی‌ها (و خط‌مشی‌های دیگر) وقتی پراکسی را ایجاد می‌کنید به‌طور خودکار اضافه می‌شوند.

در نمای «توسعه»، در پانل «جریان»، پیکان‌ها جریان را از درخواست به پاسخ نشان می‌دهند و نمادها خط‌مشی‌ها را نشان می‌دهند.

WSDL میزبانی‌شده در Edge: برای دیدن WSDL میزبانی‌شده در Edge که برای این نوع کارگزار تولید شده است، به http(s)://[proxy_domain]/[proxy_base_path]?wsdl بروید.

توسعه پراکسی پیشرفته SOAP-to-REST

بخش‌های قبلی ایجاد پراکسی API از نوع SOAP به REST را بااستفاده از دستیار پراکسی API در Edge پوشش داد. بااین‌حال، اگر می‌خواهید کنترل دقیق‌تری بر تبدیل SOAP به REST داشته باشید، می‌توانید از خودکارسازی ارائه‌شده توسط دستیار صرف‌نظر کنید و با افزودن و پیکربندی دستی خط‌مشی‌ها، کارگزار نیابتی بسازید تا به عملکرد موردنظرتان برسید. برای کسب اطلاعات بیشتر، به آموزش گام‌به‌گام: ساخت دستی پراکسی میانای برنامه‌سازی کاربردی SOAP-to-REST در Apigee Edge مراجعه کنید.