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

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

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

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

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

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

ในขั้นตอนนี้ Edge จะสร้างพร็อกซีที่จะแสดงหน้าบริการ SOAP พร็อกซี SOAP API มี 2 ประเภท ได้แก่

• พร็อกซีประเภท REST-SOAP-REST จะสร้าง RESTful API ใหม่พร้อมคำแปล ไปยัง SOAP ลูกค้าเรียกใช้โปรแกรมนี้เช่นเดียวกับบริการ RESTful อื่นๆ โดยส่งต่อคำค้นหา พารามิเตอร์ที่บริการแบ็กเอนด์ต้องการ Edge แปลค่าสิ่งนี้เป็นเพย์โหลด SOAP ที่บริการต้องการ
• ประเภทพร็อกซีพร็อกซีแบบ Pass-through จะช่วยให้ไคลเอ็นต์สามารถส่งผ่านในเพย์โหลด SOAP ได้อย่างง่ายดาย วิธีนี้ทำให้การเรียกใช้บริการ SOAP ได้รับประโยชน์จากฟีเจอร์การจัดการ Edge

กำลังทดสอบพร็อกซี

หากต้องการลองใช้พร็อกซีที่คุณสร้างไว้ ให้เปิด Command Prompt และใช้ cURL พิมพ์คำสั่ง ด้านล่าง โดยที่

• ORG คือชื่อขององค์กร Edge ที่คุณสร้างพร็อกซี
• ENV คือสภาพแวดล้อมที่ทำให้พร็อกซีใช้งานได้
• DOMAIN สอดคล้องกับอินสแตนซ์ Edge ที่คุณใช้อยู่

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

ตัวอย่างเช่น หากองค์กรของคุณคือ docfood สภาพแวดล้อมจะเป็น testและหากคุณกำลังใช้ระบบคลาวด์ Edge Enterprise คุณจะเรียกใช้คำสั่ง เช่น ดังนี้

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

หากคุณป้อน GOOG สำหรับพารามิเตอร์การค้นหาของ StockSymbol คุณควรเห็น ราคาปัจจุบันของหุ้น Alphabet Inc. คลาส 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

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

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

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

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

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

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

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

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