다음을 통해 공유

API Management로 SOAP API 가져오기 및 REST로 변환

  • 아티클

적용 대상: 모든 API Management 계층

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

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

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

참고 항목

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

필수 조건

다음 빠른 시작 Azure API Management 인스턴스 만들기를 완료합니다.

API Management 인스턴스로 이동

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

    API Management Services 선택

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

    API Management 인스턴스 선택

백 엔드 API 가져오기 및 게시

  1. 왼쪽 메뉴의 API 섹션에서 API > + API 추가를 선택합니다.

  2. 정의에서 만들기에서 WSDL을 선택합니다.

    SOAP API

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

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

    SOAP ~ REST

  5. 다음 필드는 SOAP API의 정보인 표시 이름, 이름, 설명으로 자동으로 채워집니다. 작업은 표시 이름, URL 및 설명으로 자동으로 채워지고 시스템에서 생성된 이름을 받습니다.

  6. 다른 API 설정을 입력합니다. 생성 중에 값을 설정하거나 나중에 설정 탭으로 이동하여 값을 설정할 수 있습니다.

    API 설정에 관한 자세한 내용은 첫 번째 API 가져오기 및 게시 자습서를 참조하세요.

  7. 만들기를 실행합니다.

Azure Portal에서 새 API 테스트

dAzure Portal에서 직접 작업을 호출할 수 있으며, 이 포털을 사용하면 편리한 방법으로 API의 작업을 보고 테스트할 수 있습니다.

  1. 이전 단계에서 만든 API를 선택합니다.

  2. 테스트 탭을 선택합니다.

  3. 작업을 선택합니다.

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

  4. 보내기를 누릅니다.

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

다른 API 추가

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

  • OpenAPI 사양
  • SOAP API
  • GraphQL API
  • Azure App Service에서 호스팅되는 웹앱
  • Azure 함수 앱
  • Azure Logic Apps
  • Azure Service Fabric

다음 단계를 사용하여 기존 API에 다른 API를 추가합니다.

참고 항목

다른 API를 가져오면 작업이 현재 API에 추가됩니다.

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

    포털에서 API Management 인스턴스로 이동하는 스크린샷

  2. 개요 페이지 또는 왼쪽 메뉴에서 API를 선택합니다.

    포털의 개요 페이지에서 API를 선택하는 스크린샷.

  3. 다른 API를 추가하려는 API 옆에 있는 ...를 클릭합니다.

  4. 드롭다운 메뉴에서 가져오기를 선택합니다.

    가져오기 선택

  5. API를 가져올 서비스를 선택합니다.

    포털에서 서비스를 선택하는 스크린샷

다음 단계

게시된 API 변환 및 보호