พร็อกซีบริการ SOAP

ในบทแนะนำนี้ คุณจะได้ทราบวิธีใส่พร็อกซี Edge API ด้านหน้าบริการเว็บที่ใช้ SOAP

บทแนะนำนี้แสดงวิธีสร้าง RESTful API ใหม่หน้าบริการที่ใช้ SOAP แม้ว่าจะไม่มีการอธิบายรายละเอียดในส่วนนี้ แต่คุณสามารถสร้างพร็อกซีส่งผ่านที่ยอมรับเพย์โหลด SOAP และส่งไปยังบริการแบ็กเอนด์ได้

สิ่งที่ต้องมี

• บัญชี Apigee Edge หากยังไม่มี คุณลงชื่อสมัครใช้ได้โดยใช้คำแนะนำที่การสร้างบัญชี Apigee Edge

กำลังสร้างพร็อกซี

ซึ่งคุณจะได้ให้ Edge สร้างพร็อกซีที่จะวางหน้าบริการ SOAP พร็อกซี SOAP API มีอยู่ 2 ประเภท ได้แก่

• ประเภทพร็อกซี REST-SOAP-REST จะสร้าง RESTful API ใหม่ที่มีเลเยอร์การแปลไปยัง SOAP ไคลเอ็นต์เรียกสิ่งนี้ว่าบริการ RESTful อื่นๆ โดยการส่งผ่านพารามิเตอร์การค้นหาซึ่งบริการแบ็กเอนด์ต้องการ 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 Enterprise Cloud อยู่ ให้เรียกใช้คำสั่งดังนี้

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

หากป้อน GOOG สำหรับพารามิเตอร์การค้นหา StockSymbol คุณควรได้รับราคาปัจจุบันสำหรับหุ้น Alphabet Inc. Class C เช่น

{  
   "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 ไปยัง SOAP ไปยัง REST" Edge จะสร้างข้อกําหนดของ OpenAPI โดยอัตโนมัติ คุณใช้ข้อกำหนด OpenAPI เพื่อสร้างเอกสาร API สำหรับ API ดังกล่าวได้

หากต้องการรับข้อมูลจำเพาะของ OpenAPI เพียงไปที่ URL นี้:

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

เครดิตเพิ่มเติม: คุณจะทราบได้อย่างไรว่าควรใช้ทรัพยากร คำกริยา และพารามิเตอร์การค้นหาใด

ในการเรียก API ทดสอบ คุณได้ใช้ทรัพยากรและพารามิเตอร์การค้นหาที่เฉพาะเจาะจงในการเรียก cURL ไปยังบริการ SOAP แบ็กเอนด์ แต่คุณจะรู้ด้วยตนเองได้อย่างไร

แหล่งข้อมูลและคำกริยา

ในวิซาร์ดพร็อกซี API ขณะสร้างพร็อกซี คุณได้เห็นว่าการดำเนินการ SOAP จะแมปกับคำกริยาและทรัพยากร API อย่างไร แต่หากไม่ได้จดไว้ คุณจะทราบข้อมูลนี้ได้หลังจากที่สร้างพร็อกซีแล้ว

ในแท็บพัฒนาของพร็อกซี API ในแผงการนำทางด้านซ้ายคุณจะเห็นรายการโฟลว์ใต้ปลายทางของพร็อกซี คลิกขั้นตอนที่คุณสนใจ ตัวอย่างเช่น ขั้นตอน GetQuote เป็นตัวเลือกที่ดี จากนั้นดู XML ในแผงโค้ด ซึ่งแสดงเส้นทางทรัพยากรและคำกริยาสำหรับโฟลว์ในองค์ประกอบ <Condition>: /quote และ GET

พารามิเตอร์การค้นหา

หากเลือกขั้นตอนGetQuoteแล้ว ให้คลิกนโยบายแรกในมุมมองโฟลว์แบบกราฟิก ควรเป็นนโยบายดึงข้อมูลตัวแปรที่บันทึกพารามิเตอร์การค้นหาที่คาดว่าจะส่ง: StockSymbol และ LicenseKey (หากคุณค้นหาบริการ SOAP บนเว็บ บริการจะบอกคุณว่าต้องส่งอะไรบ้างสำหรับ LicenseKey)

ระบบจะบันทึกพารามิเตอร์การค้นหาที่บันทึกเป็นตัวแปรและใช้โดยนโยบายถัดไปเพื่อสร้างข้อความ SOAP