SOAP 서비스 프록시

이 튜토리얼에서는 SOAP 기반 웹 서비스 앞에 Edge API 프록시를 사용하는 방법을 알아봅니다.

이 튜토리얼에서는 SOAP 기반 서비스 앞에 새로운 RESTful API를 생성하는 방법을 보여줍니다. 여기에서는 자세히 설명하지 않지만 SOAP 페이로드를 수락하고 백엔드 서비스에 전달하는 통과 프록시 를 생성할 수도 있습니다.

필요한 항목

• Apigee Edge 계정. 아직 계정이 없는 경우 Apigee Edge 계정 만들기의 안내에 따라 가입할 수 있습니다.

프록시 만들기

여기에서는 SOAP 서비스 앞에 위치할 프록시를 Edge에서 생성합니다. SOAP API 프록시에는 두 가지 유형이 있습니다.

• REST-SOAP-REST 프록시 유형은 SOAP에 대한 변환 레이어가 있는 새로운 RESTful API를 생성합니다. 클라이언트는 백엔드 서비스에 필요한 쿼리 매개변수를 전달하여 다른 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 엔터프라이즈 클라우드를 사용하는 경우 다음과 같은 명령어를 실행합니다.

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

StockSymbol 쿼리 매개변수에 GOOG를 입력하면 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 사양 가져오기

'REST-SOAP-REST'를 사용하여 SOAP 서비스를 프록시하면 Edge에서 OpenAPI 사양을 자동으로 생성합니다. OpenAPI 사양을 사용하여 API의 API 문서를 생성할 수 있습니다.

OpenAPI 사양을 가져오려면 이 URL을 방문하세요.

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

추가 과제: 사용할 리소스, 동사, 쿼리 매개변수를 어떻게 찾을 수 있나요?

테스트 API 호출에서 백엔드 SOAP 서비스에 대한 cURL 호출에 특정 리소스와 쿼리 매개변수를 사용했습니다. 하지만 직접 어떻게 찾을 수 있나요?

리소스 및 동사

API 프록시 마법사에서 프록시를 만들 때 SOAP 작업 이 API 동사 및 리소스에 매핑되는 방법을 확인했습니다. 하지만 이를 적어두지 않은 경우 프록시가 생성된 후 찾는 방법은 다음과 같습니다.

API 프록시의 개발 탭에 있는 왼쪽 탐색창에 프록시 엔드포인트 아래의 흐름 목록이 표시됩니다. 관심 있는 흐름을 클릭합니다. 예를 들어, GetQuote 흐름이 좋은 후보입니다. 그런 다음 코드 창에서 XML을 봅니다. 여기에는 <Condition> 요소의 흐름에 대한 리소스 경로와 동사가 표시됩니다. /quote 및 GET.

쿼리 매개변수

GetQuote 흐름을 선택한 상태에서 그래픽 흐름 뷰의 첫 번째 정책을 클릭합니다. 전달될 것으로 예상되는 쿼리 매개변수( StockSymbol 및 LicenseKey)를 캡처하는 변수 추출 정책이어야 합니다. (SOAP 서비스를 웹 검색하면 LicenseKey에 전달할 항목을 알 수 있습니다.)

캡처된 쿼리 매개변수는 변수로 저장되고 다음 정책에서 SOAP 메시지를 구성하는 데 사용됩니다.