cURL을 사용한 SOAP API 호출 (사진 포함)

"SOAP cURLs"라는 문구는 여러분이 전에 들어봤을 두 가지 인기 기술로 구성되어 있습니다. 가장 먼저, 이 글에서는 기술과 그 기능에 대해 설명합니다.

💡

Apidog는 API 설계를 우선시하는 개발 플랫폼으로, 사용자에게 전체 API 라이프사이클에 대한 다양한 수정 및 사양을 제공합니다.

API를 구축하고, 모의하고, 디버그하거나 문서화하기 위한 API 플랫폼이 필요하다면 Apidog가 최적의 선택입니다. 아래 버튼을 클릭하기만 하면 됩니다. 👇 👇 👇

SOAP 및 cURLs에 대한 기본 용어

"SOAP"와 "cURL"이라는 용어는 각각 고유한 기술을 가리킵니다.

SOAP: SOAP (간단한 객체 접근 프로토콜)는 두 응용 프로그램 또는 시스템 간에 구조화된 정보를 교환하는 데 주로 사용되는 메시징 프로토콜입니다.

데이터 교환과 다양한 소프트웨어 구성 요소 간의 통신을 촉진하는 능력 덕분에 웹 서비스 산업에서 중요한 역할을 합니다.

SOAP은 XML 형식을 사용하는 고도로 구조화된 프로토콜로, 주로 엔터프라이즈 응용 프로그램이나 레거시 시스템에 사용됩니다. 언급한 바와 같이, 많이 논의되는 REST 아키텍처 스타일과 같은 다른 프로토콜이 더 인기를 끌고 있는 것을 관찰했을 수 있습니다.

SOAP 웹 서비스는 일반적으로 WSDL 파일 형태로 제공됩니다.
cURL: cURL은 "Client for URL"의 약자입니다. cURL은 두 가지 주요 기능, 즉 명령줄 도구 curl과 라이브러리 libcurl을 제공하는 무료 오픈 소스 소프트웨어입니다.

명령줄 도구 curl은 HTTP, HTTPS 및 기타 다양한 네트워크 프로토콜을 사용하여 터미널에서 직접 데이터 전송을 수행할 수 있게 해줍니다. curl의 많은 용도가 있습니다. 몇 가지 예를 들면 파일 다운로드, 데이터 전송, 웹 페이지 또는 서버 응답의 콘텐츠 검색 등이 있습니다.

반면, 라이브러리 libcurl은 데이터 전송의 핵심 기능 역할을 합니다. libcurl은 C, C++, Python 및 PHP와 같은 다양한 인기 프로그래밍 언어에 통합될 수 있습니다. libcurl을 통해 개발자는 사용자 지정 도구나 애플리케이션을 구축하고, 파일 다운로드 및 업로드를 자동화하는 작업을 수행하여 cURL의 성능을 활용할 수 있습니다.

두 용어를 결합하면 "SOAP cURLs"는 cURL의 기능을 사용하여 SOAP 기반 웹 서비스와 구체적으로 상호작용하는 것을 의미합니다.

SOAP cURLs 작동 방식 분석

1. SOAP 메시지 정의하기:

먼저, 특정 SOAP 요청 메시지가 필요합니다. 이는 웹 서비스에서 호출하고자 하는 작업과 보낼 데이터를 XML 형식으로 결정하는 것입니다.
SOAP 메시지를 정의하는 데 도움이 되는 다양한 도구와 리소스가 제공되며, 예를 들어 웹 서비스에서 제공하는 WSDL (웹 서비스 설명 언어) 파일이나 SOAP 메시지를 생성하는 온라인 도구가 있습니다.

2. cURL 명령 구성하기:

다음으로, SOAP 메시지를 포함하는 HTTP 요청의 세부 정보를 지정하는 cURL 명령을 구성합니다. 이는 다양한 cURL 옵션을 사용하여 다음을 정의하는 작업을 포함합니다:
URL: 도달하고자 하는 웹 서비스 엔드포인트의 주소입니다.
Method: SOAP 메시지는 일반적으로 POST 방법을 사용하여 전송되므로 HTTP 방법은 일반적으로 "POST"로 설정됩니다.
Headers: "Content-Type: text/xml; charset=utf-8"와 같은 SOAP 통신을 위한 특정 헤더가 필요하여 메시지 형식과 문자 인코딩을 나타냅니다.
Data: 실제 SOAP 메시지 콘텐츠는 "-d" 옵션을 사용하여 메시지 문자열이 포함된 요청 본문에 포함됩니다.

3. 요청 전송 및 응답 수신:

cURL 명령이 완성되면 터미널에서 실행할 수 있습니다. 이렇게 하면 SOAP 메시지를 포함한 HTTP 요청이 웹 서비스로 전송됩니다.
웹 서비스는 요청을 처리하고 일반적으로 XML 형식의 응답을 반환합니다.

4. 응답 추가 처리:

XML 응답을 구문 분석하여 웹 서비스에서 반환된 관련 정보를 추출할 수 있습니다. 이는 사용된 프로그래밍 언어에 따라 도구나 라이브러리를 사용하는 것을 포함할 수 있습니다.

cURL을 사용하여 SOAP API 호출하는 방법

단계 1: 먼저, SOAP 메시지를 준비해야 합니다. SOAP 메시지를 처음 생성하는 경우 아래의 코드 샘플을 참조할 수 있지만, 필요에 맞게 수정해야 합니다.

샘플 SOAP 메시지:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://www.example.com/webservice">
   <soapenv:Header/>
   <soapenv:Body>
      <ws:getGreeting>
         <ws:name>John Doe</ws:name>
      </ws:getGreeting>
   </soapenv:Body>
</soapenv:Envelope>

메시지가 웹 서비스에 요청하는 내용은 무엇인지 추측할 수 있습니까?

단계 2: 터미널에서 cURL 명령을 준비합니다. 위 단계와 유사하게, 코드 샘플을 참조할 수 있습니다.

샘플 cURL 명령:

curl -X POST \
-H "Content-Type: text/xml; charset=utf-8" \
-H "SOAPAction: http://www.example.com/webservice/getGreeting" \
-d @soap_request.xml "https://dummy.webservice.com/path/to/service"

cURL 명령 설명:

-X POST: HTTP 요청 방법을 POST로 지정합니다.
-H "Content-Type: text/xml; charset=utf-8"는 XML 데이터가 UTF-8 인코딩으로 되어 있음을 나타내며 콘텐츠 유형 헤더를 설정합니다.
-H "SOAPAction: http://www.example.com/webservice/getGreeting"는 목표 작업을 지정하여 SOAPAction 헤더를 설정합니다.
-d @soap_request.xml는 "soap_request.xml"이라는 파일에서 SOAP 메시지 내용을 읽어옵니다.
"https://dummy.webservice.com/path/to/service"는 실제 웹 서비스 엔드포인트의 URL로 바뀌어야 합니다.

SOAP cURLs의 실제 애플리케이션

1. 레거시 시스템 통합: SOAP는 종종 구식 엔터프라이즈 애플리케이션에서 사용되었습니다. 최신 프로토콜로 마이그레이션되지 않은 이런 레거시 시스템과 상호작용해야 한다면, cURL은 데이터 교환을 위한 SOAP 요청을 수동으로 만들고 전송하는 방법을 제공할 수 있습니다.

2. SOAP 웹 서비스 테스트 및 디버깅: 개발자는 cURL을 사용하여 특정 SOAP 요청을 직접 전송하고 응답을 분석하여 SOAP 웹 서비스의 문제를 해결할 수 있습니다. 이를 통해 요청에 대한 세밀한 제어가 가능하며 잠재적인 문제를 격리하는 데 도움이 됩니다.

3. 사용자 지정 스크립트 및 자동화: cURL은 SOAP 통신과 관련된 작업을 자동화하기 위해 스크립트 및 프로그램에 통합될 수 있습니다. 정기적으로 SOAP 서비스에서 데이터를 가져오거나 수신된 SOAP 메시지를 기반으로 특정 작업을 트리거하는 시나리오에 유용할 수 있습니다.

Apidog - SOAP 테스트를 더 쉽게 만들어 줍니다

Apidog는 사용자가 원하는 대로 API를 개인화할 수 있는 여러 기능을 제공하는 API 개발 플랫폼입니다. 새로운 API를 처음부터 만들거나 오랫동안 작업해온 개인 API를 가져올 계획이라면 Apidog가 두 가지 모두를 지원합니다.

api design apidog test build — 사용자가 즐길 수 있는 Apidog 기능

button

Apidog는 WSDL 파일의 가져오기를 지원하여 SOAP 기반 웹 서비스를 볼 수 있습니다. 또한 Apidog의 클라이언트 언어 코드 생성을 사용하여 cURL 명령을 생성할 수 있어, 맞는지 틀린지 고민할 필요가 없습니다!

Apidog에서 SOAP 기반 웹 서비스를 보려면 WSDL 파일 가져오기

import wsdl file apidog — Apidog에 WSDL 파일 가져오기

먼저, 수직 도구 모음의 왼쪽에 있는 Settings 버튼을 누릅니다. 그런 다음 Data Management 섹션 아래의 Import Data를 찾습니다. 마지막으로 WSDL을 선택하여 Apidog에 WSDL 파일을 가져옵니다.

Apidog에서 WSDL 파일 편집하기

edit wsdl file apidog — Apidog으로 WSDL 파일 편집하기

WSDL 파일이 성공적으로 가져와지면, 왼쪽에 WSDL 파일이 표시되며, 이는 화살표 1에서 강조된 이미지와 같습니다. 그런 다음 번호가 매겨진 화살표를 클릭하여 편집을 시작할 수 있습니다.

WSDL 파일을 가져오고 디버그한 후에는 Apidog에서 추가 오류에 대해 테스트하기 시작할 수 있습니다. WSDL 파일이 맞는지 확실하지 않은 경우 WSDL 파일 예제를 확인하여 자세히 알아보세요.

Apidog에 cURL 가져오기

Apidog는 cURL 명령줄 코드를 준비한 사용자에게 가져오기를 지원합니다.

start curl import apidog — Apidog에서 cURL 가져오기 초기화하기

APIs 섹션에서 Apidog 창의 좌측 상단 모서리 근처에 있는 보라색 + 버튼을 찾습니다. 그런 다음 Import cURL을 선택합니다. 언급된 버튼을 찾을 수 없다면 단축키 Ctrl + I를 사용할 수 있습니다.

paste curl command apidog — 빈 필드에 cURL 명령을 붙여넣기

여기에서 cURL 명령을 붙여넣을 수 있습니다. 붙여넣은 후에는 키보드에서 Enter 키를 누르거나 OK 버튼을 눌러 cURL 명령을 확인합니다.

curl code body edit apidog — 다른 내용을 수정해야 하는지 결정합니다

성공적이라면, 위 사진과 같이 JSON 본문의 일부로 cURL 명령을 볼 수 있습니다. 여기에서 필요한 경우 어디에서나 수정을 할 수 있습니다.

Apidog을 사용한 cURL 명령 코드 생성

curl comannd code generation apidog — cURL 명령 줄 코드 생성

cURL 코드 생성을 시작하려면, Apidog 창의 오른쪽 상단 코너에 있는 </> 버튼을 찾아 누릅니다. 그런 다음 Generate Client Code를 선택합니다.

curl code generate apidog — Apidog을 사용하여 cURL 명령 줄 코드 선택

팝업 창에서 생성할 클라이언트 코드를 선택하라는 메시지가 표시됩니다. 여기에서 Shell 및 cURL을 선택합니다. 선택 후 코드를 복사하여 터미널에 붙여넣을 수 있지만, 필요에 맞게 수정해야 합니다.

결론

SOAP cURLs는 cURL 명령이 SOAP 기반 웹 서비스 통신에 사용될 수 있는 두 가지 기술입니다. 그러나 REST와 같은 더 인기 있는 아키텍처 스타일로 인해 사용이 감소하고 있다는 점은 주의해야 합니다.

Apidog는 API의 설계를 우선시하는 통합 API 개발 플랫폼입니다. Apidog를 사용하면 간단하고 직관적인 UI 덕분에 API를 쉽게 수정하고 시각적으로 설계할 수 있습니다. 또한 다양한 파일 유형 가져오기를 지원하므로 새로운 플랫폼을 시도하려는 개발자에게 유용한 선택입니다. Postman, WSDL 등 다양한 파일 형식을 지원합니다.