Ủ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 proxy API Edge lên 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. 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 qua 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 này, bạn có thể đăng ký theo hướng dẫn trong bài viết Tạo tài khoản Apigee Edge.

Tạo proxy

Tại đây, bạn sẽ thấy Edge tạo proxy trước dịch vụ SOAP. Có hai loại proxy SOAP API:

• Loại proxy REST-SOAP-REST tạo ra một API RESTful mới có lớp dịch sang SOAP. Ứng dụng gọi API này giống như 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 chuyển dữ liệu này thành tải trọng SOAP mà dịch vụ dự kiến.
• Loại proxy Proxy truyền qua cho phép ứng dụng chỉ truyền tải trọng SOAP. Đây là một cách để các cuộc gọi dịch vụ SOAP được hưởng lợi từ các tính năng quản lý Edge.

Kiểm tra proxy

Để thử proxy bạn đã tạo, hãy mở dấu nhắc 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 nơi proxy được triển khai.
• Domains 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 của Edge, thì bạn cần chạy một lệnh như sau:

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

Nếu đã nhập GOOG cho tham số truy vấn Cổ phiếu, bạn sẽ nhận được mứ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 thông số kỹ thuật OpenAPI được tạo tự động

Khi bạn proxy cho một dịch vụ SOAP bằng "REST to SOAP sang REST", Edge sẽ tự động tạo Thông số kỹ thuật OpenAPI. Bạn có thể sử dụng Thông số kỹ thuật OpenAPI để tạo tài liệu về API cho API.

Để nhận Thông số kỹ thuật OpenAPI, chỉ cần truy cập URL này:

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

Điểm cộng: Làm thế nào để bạn tìm ra tài nguyên, động từ và tham số truy vấn nên sử dụng?

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 ra đ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 thức hoạt động của SOAP ánh xạ đến các động từ và tài nguyên API. Nhưng nếu bạn không ghi lại những thông tin đó, thì dưới đây là cách bạn sẽ phát hiện được sau khi tạo proxy.

Trên thẻ Phát triển của proxy API, 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 Điểm cuối proxy. Nhấp vào quy trình mà bạn quan tâm. Ví dụ: quy trình GetQuote là một chương trình phù hợp. Sau đó, hãy xem XML trong ngăn Mã. Ngăn này hiển thị đườ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 đã 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 biểu đồ. Đó phải là một chính sách Trích xuất biến, trong đó 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ì công cụ sẽ cho bạn biết cần chuyển những gì cho LicenseKey.)

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