یک سرویس SOAP را پروکسی کنید

در این آموزش، یاد خواهید گرفت که چگونه یک پروکسی Edge API را در مقابل یک سرویس وب مبتنی بر SOAP قرار دهید.

این آموزش نحوه تولید یک RESTful API جدید را در مقابل سرویس مبتنی بر SOAP شما نشان می‌دهد. اگرچه در اینجا به تفصیل توضیح داده نشده است، اما می‌توانید یک پروکسی عبوری نیز ایجاد کنید که یک بار داده SOAP را پذیرفته و آن را به سرویس backend منتقل کند.

آنچه نیاز دارید

• یک حساب کاربری Apigee Edge. اگر هنوز حساب کاربری ندارید، می‌توانید با استفاده از دستورالعمل‌های موجود در بخش «ایجاد حساب کاربری Apigee Edge» ثبت‌نام کنید.

ایجاد پروکسی

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

• نوع پروکسی REST-SOAP-REST یک API RESTful جدید با یک لایه ترجمه به SOAP ایجاد می‌کند. کلاینت‌ها آن را مانند سایر سرویس‌های RESTful فراخوانی می‌کنند و پارامترهای پرس‌وجوی مورد نیاز سرویس backend را ارسال می‌کنند. Edge این را به بار داده SOAP مورد انتظار سرویس ترجمه می‌کند.
• نوع پروکسی عبوری به کلاینت‌ها این امکان را می‌دهد که به سادگی یک بار داده SOAP را ارسال کنند. این روشی است که فراخوانی‌های سرویس SOAP از ویژگی‌های مدیریت Edge بهره‌مند می‌شوند.

آزمایش پروکسی

برای امتحان کردن پروکسی که ایجاد کرده‌اید، یک خط فرمان باز کنید و از cURL استفاده کنید. دستور زیر را تایپ کنید، که در آن:

• ORG نام سازمان Edge است که در آن پروکسی را ایجاد کرده‌اید.
• ENV محیطی است که پروکسی در آن مستقر می‌شود.
• DOMAIN مربوط به نمونه Edge مورد استفاده شماست.

curl "https://{ORG}-{ENV}.{DOMAIN}/delayedstockquote/quote?StockSymbol=GOOG&LicenseKey=0"

برای مثال، اگر سازمان شما docfood ، محیط آن test باشد و از فضای ابری سازمانی Edge استفاده می‌کنید، دستوری مانند این را اجرا خواهید کرد:

curl "https://docfood-test.apigee.net/delayedstockquote/quote?StockSymbol=GOOG&LicenseKey=0"

اگر برای پارامتر پرس‌وجوی StockSymbol GOOG وارد کرده باشید، باید قیمت فعلی سهام کلاس C شرکت Alphabet Inc. را دریافت کنید. برای مثال:

{  
   "GetQuoteResponse":{  
      "GetQuoteResult":{  
         "StockSymbol":"GOOG",
         "LastTradeAmount":819.55,
         "LastTradeDateTime":"2017-02-13T14:33:00",
         "StockChange":5.88,
         "OpenAmount":816.0,
         "DayHigh":820.96,
         "DayLow":815.49,
         "StockVolume":785064,
         "PrevCls":813.67,
         "ChangePercent":"+0.72%",
         "FiftyTwoWeekRange":"663.28 - 841.95",
         "EarnPerShare":27.88,
         "PE":29.4,
         "CompanyName":"Alphabet Inc.",
         "QuoteError":false
      }
   }
}

مشخصات OpenAPI تولید شده خودکار را دریافت کنید

وقتی شما یک سرویس SOAP را با استفاده از "REST to SOAP to REST" پروکسی می‌کنید، Edge به طور خودکار مشخصات OpenAPI را تولید می‌کند. می‌توانید از مشخصات OpenAPI برای تولید مستندات API برای API استفاده کنید.

برای دریافت مشخصات OpenAPI، کافیست به این آدرس اینترنتی مراجعه کنید:

curl https://{ORG}-{ENV}.{DOMAIN}/delayedstockquote/openapi.json

اعتبار اضافی: چگونه متوجه می‌شوید که از کدام پارامترهای منبع، فعل و پرس‌وجو استفاده کنید؟

در فراخوانی API آزمایشی، شما از یک منبع خاص و پارامترهای پرس‌وجو در فراخوانی cURL به سرویس SOAP بک‌اند استفاده کردید. اما چگونه می‌توانید خودتان این را بفهمید؟

منبع و فعل

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

در تب Develop پروکسی API، در پنل Navigator سمت چپ، فهرستی از جریان‌ها را در زیر Proxy Endpoints مشاهده خواهید کرد. روی جریان مورد نظر خود کلیک کنید. برای مثال، جریان GetQuote گزینه خوبی است. سپس XML را در پنل Code مشاهده کنید که مسیر منبع و فعل جریان را در عنصر <Condition> نشان می‌دهد: /quote و GET .

پارامترهای پرس و جو

با انتخاب جریان GetQuote ، روی اولین خط‌مشی در نمای گرافیکی جریان کلیک کنید. این خط‌مشی باید یک خط‌مشی Extract Variables باشد که پارامترهای پرس‌وجو را که انتظار می‌رود منتقل شوند، ثبت می‌کند: StockSymbol و LicenseKey . (اگر در وب سرویس SOAP را جستجو کنید، به شما می‌گوید که برای LicenseKey چه چیزی را باید وارد کنید.)

پارامترهای کوئری گرفته شده به عنوان متغیر ذخیره می‌شوند و توسط سیاست بعدی برای ساخت پیام SOAP استفاده می‌شوند.