다음을 통해 공유

SOAP API를 Azure API Management로 가져와 REST로 변환

적용 대상: 모든 API Management 계층

이 문서에서는 SOAP API를 WSDL 사양으로 가져온 다음 REST API로 변환하는 방법을 보여 줍니다. 또한 Azure API Management에서 API를 테스트하는 방법도 보여줍니다.

이 문서에서는 다음 방법을 설명합니다.

  • SOAP API 가져오기 및 REST로 변환
  • Azure 포털에서 API 테스트하기

참고

API Management에 대한 WSDL 가져오기에는 특정 제한 사항이 적용됩니다. wsdl:import, xsd:import 및 xsd:include 지시문이 있는 WSDL 파일은 지원되지 않습니다. WSDL 파일에서 이러한 종속성을 확인하고 병합하기 위한 오픈 소스 도구는 이 GitHub 리포지토리를 참조하세요.

필수 구성 요소

API Management 인스턴스로 이동

  1. Azure Portal에서 API Management 서비스를 검색하고 선택합니다.

    검색 결과에서 API Management 서비스를 보여 주는 스크린샷

  2. API Management 서비스 페이지에서 API Management 인스턴스를 선택합니다.

    API Management 서비스 페이지의 API Management 인스턴스를 보여 주는 스크린샷

백 엔드 API 가져오기 및 게시

  1. 사이드바 메뉴의 API 섹션에서 API를 선택합니다.

  2. API 페이지에서 + API 추가를 선택합니다.

  3. 정의에서 만들기에서WSDL 타일을 선택합니다.

    Azure Portal의 WSDL 타일을 보여 주는 스크린샷

  4. WSDL 사양에서 SOAP API에 대한 URL을 입력하거나 파일 선택을 선택하여 로컬 WSDL 파일을 선택합니다.

  5. 가져오기 방법에서 SOAP에서 REST로 선택합니다.

    이 옵션을 선택하면 API Management가 XML과 JSON 간의 자동 변환을 시도합니다. 이 경우 소비자는 API를 JSON을 반환하는 RESTful API로 호출해야 합니다. API Management는 각 요청을 SOAP 호출로 변환합니다.

    SOAP to REST 옵션을 보여 주는 스크린샷.

  6. 표시 이름 및 이름 상자는 SOAP API의 정보로 자동으로 채워집니다.

  7. 다른 API 설정을 입력한 다음 만들기를 선택합니다. 나중에 설정 탭으로 이동하여 이러한 값을 구성할 수도 있습니다.

    API 설정에 대한 자세한 내용은 백 엔드 API 가져오기 및 게시를 참조하세요.

Azure 포털에서 새 API를 테스트하십시오

Azure Portal에서 직접 작업을 호출할 수 있습니다. 이 메서드는 API의 작업을 보고 테스트하는 편리한 방법을 제공합니다.

  1. 이전 단계에서 생성한 API를 선택하세요.

  2. 테스트 탭을 선택하세요.

  3. 작업을 선택하세요.

    페이지에는 쿼리 매개 변수에 대한 필드와 헤더에 대한 필드가 표시됩니다. 헤더 중 하나는 Ocp-Apim-Subscription-Key입니다. 이 헤더는 이 API와 연결된 제품의 구독 키에 대한 것입니다. API Management 인스턴스를 만들었다면 이미 관리자이므로 키가 자동으로 채워집니다.

  4. 보내기를 선택합니다.

    테스트에 성공하면 백 엔드가 200 OK와 일부 데이터로 응답합니다.

다른 API 추가

다음을 포함하여 다양한 서비스에서 노출되는 API에서 API를 작성할 수 있습니다.

  • OpenAPI 사양
  • SOAP 기반 API
  • GraphQL API
  • Azure App Service에서 호스트되는 웹앱
  • Azure Functions (애저 펑션)
  • Azure 논리 앱
  • Azure 서비스 패브릭

참고

API를 가져올 때 작업은 현재 API에 추가됩니다.

기존 API에 API를 추가하려면 다음을 수행합니다.

  1. Azure Portal에서 Azure API Management 인스턴스로 이동합니다.

    API Management 서비스 페이지를 보여 주는 스크린샷

  2. 개요 페이지에서 API를 선택하거나 사이드바 메뉴에서 API API>를 선택합니다.

    개요 페이지의 API 선택을 보여 주는 스크린샷.

  3. 다른 API를 추가할 API 옆에 있는 줄임표(...)를 선택합니다.

  4. 상황에 맞는 메뉴에서 가져오기 를 선택합니다.

    가져오기 명령을 보여 주는 스크린샷.

  5. API를 불러올 서비스를 선택하세요.

관련 콘텐츠

  • Last updated on