학습서: 기존 SOAP 서비스를 호출하는 REST API 정의 작성
이 학습서에서는 기존 SOAP 서비스를 공개하고 이 서비스에서 리턴하는 XML 데이터를 지정된 JSON 데이터로 변환하는 방법을 보여줍니다.
이 학습서에 대한 정보
이 튜토리얼에 따라 기존 SOAP 서비스에 대한 WSDL을 가져와서 API 관리자에서 REST API를 만들 수 있습니다. SOAP 1.1 및 SOAP 1.2 표준은 모두 API Connect 에서 지원됩니다. 호출 시 API는 특정 사용자의 가상 은행 계좌의 잔액을 리턴합니다.
이 학습서에서는 다음 활동을 완료합니다.
시작하기 전에
참고: 샌드박스 카탈로그는 DataPower® API Gateway 또는 DataPower Gateway (v5 compatible) 또는 둘 다 사용하도록 구성해야 합니다. 카탈로그 만들기 및 구성하기를 참조하세요.
REST API 정의 설정
기존 SOAP 서비스를 호출하는 REST API를 설정하려면 다음 단계를 완료하십시오.
- API 및 제품 개발 타일을 클릭하십시오.
- 클릭합니다.
- 기존 WSDL 서비스(REST 프록시)에서를 선택하십시오. 다음을 클릭하십시오.
- 파일 업로드 섹션에서 AccountServicing.wsdl 파일을
끌어서 놓거나 파일 시스템에서 업로드하도록 클릭하십시오.
- 서비스를 선택합니다 AccountServicing WSDL 서비스를 선택하고 다음을 클릭합니다.
- 정보 섹션에서 값을 변경하지 않고 그대로 두고 다음을 클릭합니다.
- 보안 섹션에서 키 단위로 API 호출
제한 선택란을 선택하고 API 활성화 섹션에서
API 활성화 선택란을 선택하십시오. 다음을 클릭하십시오.
- 새 API 작성 및 공개 단계를 보여주는 요약 화면이
이제 표시됩니다. 이 프로세스가 완료되면
새 API에 자동으로 등록된 샌드박스 테스트 애플리케이션의 신임 정보 및 API
기본 엔드포인트를 포함한 결과 요약이 표시됩니다.
- API 편집을 클릭합니다. 새 API가 이제 온라인 상태입니다.
기존 SOAP 서비스를 호출하는 REST API를 작성했고 테스트 준비가 된 제품과 플랜에 이를 포함시켰습니다. WSDL 파일은 API 입력 및 응답을 구성하는 데 필요한 모든 정보를 제공했습니다.
API 정의 테스트
참고: 크로스 오리진 리소스 공유( CORS ) 제한 사항으로 인해, macOS Catalina 플랫폼의 Chrome 또는 Safari 브라우저에서는 어셈블리 테스트 도구를 사용할 수 없습니다.
API 관리자 테스트 도구를 사용하여 API 정의를 테스트하려면 다음 단계를 완료하세요.
- AccountServicing API의 ‘Assemble’ 탭을 클릭하여 ‘Assemble’ 보기로 이동한 다음,
‘Test’ 아이콘을 클릭합니다.
테스트 패널이 더 이상 사용되지 않고 있으며 이후 릴리스에서는 테스트 탭으로 이동됨에 유의하십시오.
- 테스트 패널이 열리고 테스트 설정에 필요한 기본 제품과
플랜이 나열되어 있는지 확인할 수 있습니다.
- 작업 섹션에서 호출할 /getBalance 작업을 선택합니다.
- 테스트 패널에서 요청 필드로
화면 이동하고 생성을 클릭하여 샘플 요청을 자동 생성하십시오.
- 호출을 클릭하여 API를 테스트합니다. API 응답이 응답 섹션에 표시됩니다. 신뢰할 수 있는 인증서와 관련된 메시지를 수신하는 경우 제공된 링크를 클릭하여 인증서를 승인한 후
테스트 환경으로 돌아가서 호출을 다시 클릭하십시오.
응답 섹션이 정상적으로 계좌의 잔액을 리턴합니다.
이 학습서에서 수행한 작업
이 튜토리얼에서 다음 활동을 완료했습니다.
- REST API 정의를 설정했습니다.
- 기존 웹 서비스를 호출하고 해당 출력을 리턴하도록 SOAP WSDL 파일에 기반한 API를 구성했습니다.
- API 정의를 테스트했습니다.
This section will need to be redone after the new Test tab is available for both gateways.