Ủy quyền một dịch vụ SOAP

Trong hướng dẫn này, bạn sẽ tìm hiểu cách đặt một proxy API Edge trước một dịch vụ web dựa trên SOAP.

Hướng dẫn này minh hoạ cách tạo một API RESTful mới trước dịch vụ dựa trên SOAP của bạn. Mặc dù không được mô tả chi tiết ở đây, nhưng bạn cũng có thể tạo một proxy truyền dữ liệu chấp nhận tải trọng SOAP và truyền tải trọng đó đến dịch vụ phụ trợ.

Bạn cần có

• Một tài khoản Apigee Edge. Nếu chưa có tài khoản, bạn có thể đăng ký theo hướng dẫn tại Tạo tài khoản Apigee Edge.

Tạo proxy

Tại đây, bạn sẽ để Edge tạo proxy nằm trước một dịch vụ SOAP. Có 2 loại proxy API SOAP:

• Loại proxy REST-SOAP-REST tạo ra một API RESTful mới có lớp dịch sang SOAP. Các ứng dụng gọi dịch vụ này như cách chúng gọi các dịch vụ RESTful khác, truyền các tham số truy vấn mà dịch vụ phụ trợ cần. Edge sẽ dịch yêu cầu này thành tải trọng SOAP mà dịch vụ mong đợi.
• Loại proxy Pass-through proxy cho phép các ứng dụng chỉ cần truyền tải một tải trọng SOAP. Đây là cách để các lệnh gọi dịch vụ SOAP tận dụng các tính năng quản lý Edge.

Kiểm thử proxy

Để dùng thử proxy mà bạn đã tạo, hãy mở giao diện nhập dòng lệnh và sử dụng cURL. Nhập lệnh bên dưới, trong đó:

• ORG là tên của tổ chức Edge mà bạn đã tạo proxy.
• ENV là môi trường mà proxy được triển khai.
• DOMAIN tương ứng với phiên bản Edge mà bạn đang sử dụng.

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

Ví dụ: nếu tổ chức của bạn là docfood, môi trường là test và bạn đang sử dụng đám mây doanh nghiệp Edge, thì bạn sẽ chạy một lệnh như sau:

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

Nếu bạn nhập GOOG cho tham số truy vấn StockSymbol, bạn sẽ nhận được giá hiện tại của cổ phiếu Loại C của Alphabet Inc. Ví dụ:

{  
   "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
      }
   }
}

Nhận OpenAPI Specification được tạo tự động

Khi bạn uỷ quyền cho một dịch vụ SOAP bằng cách sử dụng "REST to SOAP to REST", Edge sẽ tự động tạo một Quy cách OpenAPI. Bạn có thể sử dụng OpenAPI Spec để tạo tài liệu API cho API.

Để lấy OpenAPI Spec, bạn chỉ cần truy cập vào URL này:

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

Điểm cộng: Làm cách nào để biết cần sử dụng tài nguyên, động từ và tham số truy vấn nào?

Trong lệnh gọi API kiểm thử, bạn đã sử dụng một tài nguyên và tham số truy vấn cụ thể trong lệnh gọi cURL đến dịch vụ SOAP phụ trợ. Nhưng làm cách nào để bạn tự tìm hiểu điều đó?

Tài nguyên và động từ

Trong trình hướng dẫn proxy API khi tạo proxy, bạn đã thấy cách các thao tác SOAP sẽ liên kết với các động từ và tài nguyên API. Nhưng nếu không ghi lại những thông tin đó, bạn có thể tìm hiểu cách tìm thông tin sau khi tạo proxy.

Trên thẻ Phát triển của API proxy, trong ngăn Trình điều hướng bên trái, bạn sẽ thấy danh sách các luồng trong Proxy Endpoints. Nhấp vào luồng mà bạn quan tâm. Ví dụ: quy trình GetQuote là một lựa chọn phù hợp. Sau đó, hãy xem XML trong ngăn Code (Mã). Ngăn này cho biết đường dẫn tài nguyên và động từ cho luồng trong phần tử <Condition>: /quote và GET.

Tham số truy vấn

Khi bạn chọn quy trình GetQuote, hãy nhấp vào chính sách đầu tiên trong chế độ xem quy trình dạng đồ hoạ. Đây phải là chính sách Trích xuất biến, ghi lại các tham số truy vấn dự kiến sẽ được truyền: StockSymbol và LicenseKey. (Nếu bạn tìm kiếm dịch vụ SOAP trên web, thì dịch vụ này sẽ cho bạn biết những gì cần truyền cho LicenseKey.)

Các tham số truy vấn được ghi lại sẽ được lưu dưới dạng các biến và được chính sách tiếp theo sử dụng để tạo thông báo SOAP.