Gọi API SOAP bằng cURL (Kèm Hình Ảnh)

Cụm từ "SOAP cURLs" bao gồm hai công nghệ phổ biến mà bạn có thể đã nghe trước đây. Trước tiên, bài viết này sẽ thảo luận về các công nghệ và khả năng của chúng.

💡

Apidog, một nền tảng phát triển API theo thiết kế đầu tiên, cung cấp cho người dùng nhiều sửa đổi và thông số cho toàn bộ vòng đời API.

Nếu bạn cần một nền tảng API để xây dựng, mô phỏng, gỡ lỗi hoặc tài liệu API, Apidog là một lựa chọn tối ưu. Tất cả những gì bạn phải làm là nhấp vào nút bên dưới. 👇 👇 👇

Thuật ngữ cơ bản về SOAP và cURLs

Các thuật ngữ "SOAP" và "cURL" mỗi cái đề cập đến một công nghệ độc đáo.

SOAP: SOAP (Giao thức truy cập đối tượng đơn giản) là một giao thức nhắn tin chủ yếu được sử dụng để trao đổi thông tin có cấu trúc giữa hai ứng dụng hoặc hệ thống.

Nó đóng vai trò quan trọng trong ngành dịch vụ web nhờ khả năng tạo điều kiện cho việc trao đổi dữ liệu và giao tiếp giữa các thành phần phần mềm khác nhau.

SOAP là một giao thức có cấu trúc cao sử dụng định dạng XML, chủ yếu được sử dụng cho các ứng dụng doanh nghiệp hoặc hệ thống kế thừa. Với điều này đã được đề cập, bạn có thể đã thấy các giao thức khác trở nên phổ biến hơn, chẳng hạn như kiến trúc REST đang được thảo luận nhiều.

Dịch vụ web SOAP cũng thường có dạng tệp WSDL.
cURL: cURL là viết tắt của "Client for URL". cURL là một phần mềm mã nguồn mở miễn phí cung cấp hai chức năng chính, một công cụ dòng lệnh curl và một thư viện libcurl.

Công cụ dòng lệnh curl cho phép truyền dữ liệu bằng cách sử dụng nhiều giao thức mạng khác nhau như HTTP, HTTPS và nhiều loại khác trực tiếp từ terminal của bạn. Có nhiều cách sử dụng curl. Để liệt kê một vài cách, bạn có thể tải xuống tệp, gửi dữ liệu và lấy nội dung của một trang web hoặc phản hồi từ máy chủ.

Mặt khác, thư viện libcurl đóng vai trò là chức năng cốt lõi cho việc truyền dữ liệu. libcurl có thể được tích hợp vào nhiều ngôn ngữ lập trình phổ biến, như C, C++, Python và PHP. Với libcurl, các nhà phát triển có thể tận dụng hiệu suất của cURL cho các ứng dụng trong các tác vụ như tự động tải xuống và tải lên tệp, cũng như xây dựng các công cụ hoặc ứng dụng tùy chỉnh để tương tác với dịch vụ web.

Khi các thuật ngữ kết hợp lại, "SOAP cURLs" đề cập đến việc sử dụng chức năng của cURL để tương tác cụ thể với dịch vụ web dựa trên SOAP.

Phân tích cách thức hoạt động của SOAP cURLs

1. Định nghĩa tin nhắn SOAP:

Đầu tiên, một tin nhắn yêu cầu SOAP cụ thể là cần thiết. Điều này liên quan đến việc xác định hoạt động mà bạn muốn gọi trên dịch vụ web và dữ liệu mà bạn muốn gửi, tất cả trong định dạng XML.
Bạn có thể tìm thấy nhiều công cụ và tài nguyên có sẵn để giúp bạn định nghĩa tin nhắn SOAP, chẳng hạn như tệp WSDL (Ngôn ngữ mô tả dịch vụ web) do dịch vụ web cung cấp hoặc các công cụ trực tuyến để tạo tin nhắn SOAP.

2. Xây dựng lệnh cURL:

Kế tiếp, xây dựng một lệnh cURL chỉ định chi tiết của yêu cầu HTTP mang theo tin nhắn SOAP. Điều này liên quan đến việc sử dụng nhiều tùy chọn cURL để định nghĩa:
URL: Địa chỉ của điểm cuối dịch vụ web mà bạn muốn truy cập.
Phương thức: Phương thức HTTP thường được đặt là "POST" vì các tin nhắn SOAP thường được gửi bằng phương thức POST.
Tiêu đề: Các tiêu đề cụ thể cho giao tiếp SOAP, chẳng hạn như "Content-Type: text/xml; charset=utf-8" là cần thiết để chỉ ra định dạng tin nhắn và mã hóa ký tự.
Dữ liệu: Nội dung thực tế của tin nhắn SOAP sẽ được bao gồm trong thân yêu cầu bằng cách sử dụng tùy chọn "-d" với chuỗi tin nhắn hoặc một tệp chứa tin nhắn.

3. Gửi yêu cầu và nhận phản hồi:

Khi bạn đã có lệnh cURL hoàn chỉnh, bạn có thể thực thi nó trong terminal của mình. Điều này sẽ gửi yêu cầu HTTP đã tạo chứa tin nhắn SOAP đến dịch vụ web.
Dịch vụ web sẽ xử lý yêu cầu và trả về phản hồi, thường ở định dạng XML.

4. Xử lý phản hồi:

Bạn có thể phân tích phản hồi XML để trích xuất thông tin có liên quan được trả về bởi dịch vụ web. Điều này có thể liên quan đến việc sử dụng các công cụ hoặc thư viện tùy thuộc vào ngôn ngữ lập trình được sử dụng.

Cách gọi API SOAP bằng cURL

Bước 1: Đầu tiên, bạn sẽ cần chuẩn bị tin nhắn SOAP của mình. Trong trường hợp đây là lần đầu tiên bạn tạo một tin nhắn SOAP, bạn có thể tham khảo mẫu mã dưới đây - tuy nhiên, bạn sẽ cần sửa đổi nó để đảm bảo nó đáp ứng nhu cầu của bạn.

Mẫu tin nhắn 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>

Bạn có đoán được tin nhắn đang yêu cầu gì từ dịch vụ web không?

Bước 2: Chuẩn bị lệnh cURL của bạn trên terminal. Tương tự như bước trên, bạn có thể xem mẫu mã.

Mẫu lệnh 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"

Giải thích lệnh cURL:

-X POST: Chỉ định phương thức yêu cầu HTTP là POST.
-H "Content-Type: text/xml; charset=utf-8" thiết lập tiêu đề content-type bằng cách chỉ ra dữ liệu XML với mã hóa UTF-8.
-H "SOAPAction: http://www.example.com/webservice/getGreeting" thiết lập tiêu đề SOAPAction bằng cách chỉ định hoạt động mục tiêu.
-d @soap_request.xml đọc nội dung tin nhắn SOAP từ một tệp có tên "soap_request.xml".
"https://dummy.webservice.com/path/to/service" được thay thế bằng URL thực tế của điểm cuối dịch vụ web.

Các ứng dụng thực tế của SOAP cURLs

1. Tích hợp hệ thống kế thừa: SOAP thường được sử dụng trong các ứng dụng doanh nghiệp cũ. Nếu bạn cần tương tác với các hệ thống kế thừa như vậy chưa được chuyển sang các giao thức mới hơn, cURL có thể cung cấp cách để thủ công tạo và gửi các yêu cầu SOAP để trao đổi dữ liệu.

2. Kiểm tra và gỡ lỗi dịch vụ web SOAP: Các nhà phát triển có thể sử dụng cURL để trực tiếp gửi các yêu cầu SOAP cụ thể và phân tích các phản hồi để khắc phục sự cố với dịch vụ web SOAP. Điều này cho phép kiểm soát chi tiết hơn về yêu cầu và giúp cô lập các vấn đề tiềm ẩn.

3. Script tùy chỉnh và tự động hóa: cURL có thể được tích hợp vào các script và chương trình để tự động hóa các tác vụ liên quan đến giao tiếp SOAP. Điều này có thể hữu ích cho các kịch bản như lấy dữ liệu thường xuyên từ một dịch vụ SOAP hoặc kích hoạt các hành động cụ thể dựa trên các tin nhắn SOAP đã nhận.

Apidog - Làm cho việc kiểm tra SOAP dễ dàng hơn

Apidog là một nền tảng phát triển API cung cấp nhiều chức năng để cá nhân hóa các API theo thông điệp của bạn. Dù bạn đang có kế hoạch tạo một API mới từ đầu hay nhập một API cá nhân mà bạn đã làm việc trong một thời gian, Apidog đều hỗ trợ cả hai lựa chọn.

api design apidog test build — Các chức năng của Apidog mà người dùng có thể tận hưởng

button

Apidog hỗ trợ nhập các tệp WSDL để bạn có thể xem các dịch vụ web dựa trên SOAP. Ngoài ra, bạn cũng có thể tạo lệnh cURL bằng cách sử dụng mã sinh ngôn ngữ của Apidog, vì vậy bạn không cần phải đoán xem liệu mình đúng hay sai!

Nhập tệp WSDL để xem các dịch vụ web dựa trên SOAP trên Apidog

import wsdl file apidog — Nhập tệp WSDL vào Apidog

Đầu tiên, nhấn nút Settings nằm ở phía bên trái của thanh công cụ đứng. Sau đó, tìm Import Data trong phần Data Management. Cuối cùng, chọn WSDL để nhập các tệp WSDL vào Apidog.

Chỉnh sửa tệp WSDL trên Apidog

edit wsdl file apidog — Chỉnh sửa tệp WSDL bằng Apidog

Nếu tệp WSDL đã được nhập thành công, bạn sẽ thấy tệp WSDL của mình ở bên trái, như hình ảnh được chỉ trên mũi tên 1. Bạn có thể nhấn vào các mũi tên có số để bắt đầu chỉnh sửa.

Khi bạn đã nhập và gỡ lỗi tệp WSDL, bạn có thể bắt đầu kiểm tra nó trên Apidog để tìm thêm lỗi. Nếu bạn vẫn không chắc chắn liệu tệp WSDL của mình có đúng hay không, hãy tham khảo các ví dụ về tệp WSDL để biết thêm chi tiết.

Nhập cURL vào Apidog

Apidog hỗ trợ nhập mã lệnh cURL cho những người đã chuẩn bị sẵn.

start curl import apidog — Khởi tạo nhập cURL trên Apidog

Trong phần APIs, tìm nút màu tím + nằm ở góc trên bên trái của cửa sổ Apidog. Sau đó chọn Import cURL. Nếu bạn không thể tìm thấy nút đã đề cập, bạn có thể sử dụng phím tắt, Ctrl + I.

paste curl command apidog — Dán lệnh cURL của bạn vào trường trống

Tại đây, bạn có thể dán lệnh cURL của mình. Khi đã xong, nhấn Enter trên bàn phím của bạn hoặc nút OK để xem lệnh cURL của bạn.

curl code body edit apidog — Quyết định xem bạn có cần chỉnh sửa gì khác không

Nếu thành công, bạn có thể xem lệnh cURL như một phần của thân JSON, như đã được chỉ ra trong hình ảnh trên. Tại đây, bạn có thể thực hiện các điều chỉnh hoặc thay đổi, bất cứ nơi đâu và bất cứ khi nào cần thiết.

Tạo mã lệnh cURL bằng Apidog

curl comannd code generation apidog — Tạo mã lệnh cURL

Để bắt đầu tạo mã lệnh cURL, hãy tìm và nhấn nút </> nằm ở góc trên bên phải của cửa sổ Apidog. Sau đó, chọn Generate Client Code.

curl code generate apidog — Chọn mã lệnh cURL bằng Apidog

Một cửa sổ bật lên sẽ yêu cầu bạn chọn mã khách nào để tạo. Tại đây, hãy chọn Shell và cURL. Khi bạn đã chọn, bạn có thể sao chép mã và dán nó vào terminal của bạn. Tuy nhiên, hãy đảm bảo rằng bạn sửa đổi nó sao cho phù hợp với nhu cầu của bạn.

Kết luận

SOAP cURLs là hai công nghệ có thể hoạt động đồng hành, trong đó các lệnh cURL có thể được sử dụng để giao tiếp với dịch vụ web dựa trên SOAP. Tuy nhiên, hãy lưu ý rằng việc sử dụng của chúng đang giảm do các phong cách kiến trúc phổ biến hơn như REST.

Apidog là một nền tảng phát triển API tất cả trong một, khuyến khích phát triển theo thiết kế đầu tiên cho các API. Với Apidog, bạn có thể dễ dàng sửa đổi và thiết kế các API một cách trực quan nhờ vào giao diện người dùng đơn giản và trực quan của nó. Hơn nữa, đây là một lựa chọn vững chắc cho bất kỳ nhà phát triển nào đang quan tâm đến việc thử nghiệm một nền tảng mới vì Apidog hỗ trợ nhập các loại tệp khác nhau, bao gồm Postman, WSDL và nhiều hơn nữa.